# Structure de la Bibliothèque de Skills

## Arborescence

```
mes_skills/
├── skills/                     ← bibliothèque principale
│   ├── <categorie>/            ← catégorie (dev, infra, jardinage, ...)
│   │   └── <nom-skill>/        ← un dossier par skill
│   │       ├── claude-code.md  ← variante Claude Code
│   │       ├── gemini-cli.md   ← variante Gemini CLI
│   │       ├── codex.md        ← variante Codex
│   │       └── hermes.md       ← variante Hermes Agent
├── templates/                  ← squelettes vierges par agent
│   ├── claude-code.md
│   ├── gemini-cli.md
│   ├── codex.md
│   └── hermes.md
├── web/                        ← portail web statique (Hugo + Docker)
├── docs/                       ← documentation du dépôt
├── tests/                      ← tests bash de install.sh
├── install.sh                  ← installeur interactif
├── README.md
├── evolution.md
└── CLAUDE.md
```

## Catégories disponibles

| Catégorie | Usage |
|-----------|-------|
| `dev` | Développement : debug, git, tests, refactoring |
| `infra` | Infrastructure : docker, proxmox, homelab |
| `ai` | Agents IA : prompting, workflows |
| `tools` | Scripts utilitaires, automatisations |
| `jardinage` | Jardinage et plantes |
| `electronique` | Électronique, Arduino, ESP32 |
| `diy` | Bricolage, impression 3D |
| `task` | Gestion de tâches, organisation |

## Conventions

- Nom du skill : kebab-case (`mon-skill`)
- Nom des fichiers : `<agent>.md` (ex: `claude-code.md`)
- Version : semver `X.Y.Z` dans le frontmatter
- Tags : minuscules, sans espace (ex: `[bash, debug]`)
- L'installeur copie `<agent>.md` → `SKILL.md` dans la destination

## Ajouter un nouveau skill

1. Créer le dossier : `skills/<categorie>/<nom>/`
2. Copier un template depuis `templates/<agent>.md`
3. Remplir le frontmatter et le contenu
4. Committer et pusher vers Gitea