gilles
ff632f6953
Spec complète du dépôt de skills IA avec installeur bash interactif. Structure dépôt, format skills par agent, palette Gruvbox, site web Hugo prévu. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
50 lines
2.1 KiB
Markdown
50 lines
2.1 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## Contexte du projet
|
|
|
|
Dépôt personnel de skills pour agents IA (Claude Code, Codex, Gemini CLI, Hermes Agent), hébergé sur Gitea (`https://gitea.maison43.duckdns.org/gilles/mes_skills`).
|
|
|
|
L'objectif principal est de développer un installeur shell permettant d'installer, activer/désactiver et gérer les skills depuis ce dépôt.
|
|
|
|
## Langue et style
|
|
|
|
- Communiquer en **français** avec l'utilisateur
|
|
- Les commentaires dans le code sont en **français**
|
|
- Déployer un plan avant toute écriture de code
|
|
|
|
## Philosophie technique
|
|
|
|
- **Bash uniquement** — pas de Node.js, pas de Docker, pas de frameworks lourds
|
|
- Dépendances minimales : `bash`, `curl`, `wget`, `git`
|
|
- Python accepté uniquement si nécessaire, avec `python3 -m venv` ou `uv venv` (jamais `pip install` global)
|
|
- Cible : Debian/Ubuntu, Proxmox, VM légères, homelab
|
|
|
|
## Architecture prévue
|
|
|
|
### Structure des dossiers de skills
|
|
|
|
À définir par brainstorming — classement judicieux et évolutif pour plusieurs agents IA.
|
|
|
|
### Script d'installation (`install.sh`)
|
|
|
|
Point d'entrée : `curl -fsSL https://gitea.maison43.duckdns.org/gilles/mes_skills/install.sh | bash`
|
|
|
|
Comportement attendu :
|
|
1. Détecter les outils présents (`git`, `curl`, `wget`, `python3`, `uv`, `docker`, `podman`)
|
|
2. Détecter les agents IA installés sur le système
|
|
3. Détecter les skills déjà installés (globalement et localement)
|
|
4. Cloner le dépôt dans un répertoire temporaire
|
|
5. Menu interactif (flèches haut/bas, espace, entrée, échap) pour sélectionner les skills
|
|
6. Choix d'installation : global ou projet courant
|
|
7. Gestion du versioning des skills
|
|
8. Détection de skills locaux absents du dépôt → upload optionnel vers Gitea
|
|
|
|
## Structure d'un skill
|
|
|
|
Consulter la référence de chaque agent pour la structure exacte :
|
|
- Claude Code : `~/.claude/skills/` (fichiers Markdown avec frontmatter YAML)
|
|
- Gemini CLI : structure similaire
|
|
- Hermes Agent : voir `https://github.com/NousResearch/hermes-agent/blob/main/scripts/install.sh` comme inspiration pour la mécanique d'installation
|