Files
mes_skills/CLAUDE.md
T
gilles ff632f6953 chore: add project spec and CLAUDE.md
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>
2026-05-16 03:55:21 +02:00

2.1 KiB

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