docs: référence format SKILL.md, structure dépôt et architecture install.sh
This commit is contained in:
@@ -0,0 +1,54 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user