# 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