goromal/agent-skills

À utiliser lorsqu'il s'agit de modifier, créer ou supprimer une compétence d'agent. Les compétences partagées proviennent du dépôt agent-skills ; les compétences locales en aval restent dans leur dépôt propriétaire.

Qu'est-ce que agent-skills ?

Cette compétence d'agent fournit des directives claires sur la gestion des compétences d'agent (skills) dans un environnement multi-dépôts avec gestionnaire de paquets Nix et home-manager. Elle explique l'origine des compétences installées (dossiers `~/.claude/skills/`, `~/.agents/skills/`, `~/.codex/skills/`) et comment les modifier, créer ou supprimer en toute sécurité. Le système distingue les compétences partagées, hébergées dans le dépôt central `agent-skills`, et les compétences locales en aval, maintenues dans leur dépôt propriétaire. La compétence est utile pour les développeurs utilisant Claude, Codex ou d'autres agents similaires, car elle évite les modifications accidentelles dans les liens symboliques gérés par home-manager et garantit une traçabilité correcte via des branches de fonctionnalités et des PR. Elle couvre également l'intégration avec le catalogue Nix (`catalog.nix`), les verrous de flake et les overlays en aval.

Compatible avec✓Claude Code✓Codex CLI~Cursor

npx skills add https://github.com/goromal/agent-skills/tree/HEAD/skills/editing-skills

Documentation

D'où proviennent les compétences installées

Les compétences d'agent sont installées par home-manager sous ~/.claude/skills/, ~/.agents/skills/ et ~/.codex/skills/. Ces chemins gérés pointent vers le répertoire source de la compétence. Modifiez le dépôt propriétaire plutôt qu'un lien installé.

Les sources et ressources des compétences partagées se trouvent dans le répertoire agent-skills/skills/<nom>/ de l'espace de travail. Le catalogue Nix agent-skills/catalog.nix sélectionne les compétences partagées pour les consommateurs. Les overlays en aval peuvent ajouter des chemins de compétences locales via leur propre configuration machines.claude.skills et machines.codex.skills ; conservez ces fichiers dans le dépôt en aval.

Modifier une compétence partagée

Modifiez son répertoire dans le checkout agent-skills de l'espace de travail.
Si la modification met également à jour un consommateur, utilisez la même branche de fonctionnalités dans les deux dépôts. Ajoutez agent-skills à l'espace de travail avec addsrc agent-skills [email protected]:goromal/agent-skills.git s'il n'est pas présent.
Testez une intégration anixpkgs à l'aide d'une entrée flake locale temporaire si nécessaire. Avant de pousser, restaurez l'URL de la branche de fonctionnalités distante et verrouillez-la avec nix flake update agent-skills.
Ouvrez la PR agent-skills et liez-la depuis la PR consommateur. Fusionnez d'abord la PR source de la compétence, puis ré-épinglez les consommateurs vers la révision main fusionnée.

Créer une compétence partagée

Ajoutez skills/<nom-compétence>/SKILL.md dans agent-skills ; conservez les références, exemples, scripts et ressources à côté.
Ajoutez { name = "<nom-compétence>"; file = ./skills/<nom-compétence>/SKILL.md; } à catalog.nix. Les entrées s'appliquent par défaut à Claude et Codex ; définissez frameworks si nécessaire.
Liez les ressources de support de manière relative au dossier de la compétence et mettez à jour les verrous en aval.

Modifier une compétence locale en aval

Modifiez-la dans le dépôt qui possède l'overlay ou le module contribuant au chemin de la compétence. Gardez le répertoire autonome, y compris les références. Sa configuration peut ajouter une entrée { name, file } à l'option skills du framework.

Supprimer ou remplacer une compétence partagée

Supprimez son entrée de catalog.nix et supprimez son dossier source, puis mettez à jour les verrous en aval. Pour remplacer une compétence partagée sur une machine, listez son nom dans machines.agents.excludedSkills et ajoutez le chemin de la compétence locale avec ce nom dans le module en aval.