diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2adf730
--- /dev/null
+++ b/README.md
@@ -0,0 +1,54 @@
+# mes_skills — Bibliothèque personnelle de skills IA
+
+Dépôt Gitea personnel de skills réutilisables pour agents IA :
+**Claude Code**, **Gemini CLI**, **Codex (OpenAI)**, **Hermes Agent**.
+
+## Installation rapide
+
+```bash
+curl -fsSL https://gitea.maison43.duckdns.org/gilles/mes_skills/raw/branch/main/install.sh | bash
+```
+
+## Ce que fait l'installeur
+
+1. Détecte les agents IA présents sur ton système
+2. Affiche la liste des skills disponibles avec leur statut (installé / nouveau / MAJ dispo)
+3. Menu interactif fzf : TAB pour choisir local/global/ignorer, ENTER pour confirmer
+4. Installe sans sudo dans `~/.claude/skills/`, `~/.gemini/skills/`, etc.
+5. Affiche les commandes pour tester chaque skill installé
+
+## Options avancées
+
+```bash
+SKILLS_DEBUG=1    bash install.sh   # mode verbeux
+SKILLS_DRY_RUN=1  bash install.sh   # simulation sans écriture
+SKILLS_TAG=bash   bash install.sh   # filtre par tag
+SKILLS_REPO=/path bash install.sh   # dépôt local (sans clone)
+```
+
+## Structure du dépôt
+
+```
+skills/<categorie>/<nom>/
+  claude-code.md    ← skill pour Claude Code
+  gemini-cli.md     ← skill pour Gemini CLI
+  codex.md          ← skill pour Codex
+  hermes.md         ← skill pour Hermes
+```
+
+Voir [docs/structure_repo.md](docs/structure_repo.md) pour le détail complet.
+
+## Créer un nouveau skill
+
+```bash
+cp templates/claude-code.md skills/dev/mon-skill/claude-code.md
+# Éditer le fichier, remplir name, version, description, tags
+# Committer et pusher
+```
+
+## Documentation
+
+- [Format des skills par agent](docs/structure_skill.md)
+- [Structure du dépôt](docs/structure_repo.md)
+- [Architecture de install.sh](docs/structure_script_install.md)
+- [Évolutions prévues](evolution.md)
diff --git a/evolution.md b/evolution.md
new file mode 100644
index 0000000..3a04a06
--- /dev/null
+++ b/evolution.md
@@ -0,0 +1,23 @@
+# Évolutions et Améliorations Prévues
+
+## v2 — Site web statique (en cours de conception)
+
+- Portail Hugo + Docker dans `web/`
+- Navigation par catégorie, agent et tags
+- Style CSS Gruvbox dark
+- Synchronisation automatique avec le dépôt Gitea (git pull toutes les heures)
+- Voir `docs/superpowers/plans/` pour le plan d'implémentation
+
+## v2.1 — Éditeur de skills depuis le navigateur
+
+- Éditeur Markdown intégré au portail web
+- Création depuis template
+- Push vers Gitea via token API
+
+## Futures idées
+
+- Upload de skills locaux vers Gitea (token API)
+- Support des dossiers `scripts/` et `references/` (format Hermes complet)
+- Signature/vérification d'intégrité des skills
+- Synchronisation automatique via cron système
+- Interface similaire à [skillsmp.com](https://skillsmp.com/fr)