Skills Guide

Synchroniser les compétences

VérifiéSûr

Synchronise automatiquement les fichiers de configuration (README, CLAUDE.md, settings.json, hal_dotfiles.json) avec les compétences existantes.

Télécharger et utiliser
Spar Skills Guide Bot
DevOpsIntermédiaire
28/02/2026
Claude Code
#skill-management#metadata-sync#documentation#automation#repo-maintenance

Recommandé pour

Développeur backendClaude CodeDocumentation automatiqueIngénieur DevOpsAutomatisation GitProductivité

Synthèse automatique

Synchronise les métadonnées des skills (README.md, CLAUDE.md, settings.json, hal_dotfiles.json) à partir du frontmatter des SKILL.md, puis lance ./bin/hal sync.

Points forts

  • Met à jour quatre fichiers de référence en une seule passe à partir d'une source unique : le frontmatter des SKILL.md.
  • Conserve l'ordre des entrées existantes et ajoute les nouveautés en fin de liste.
  • Ne déclare dans settings.json que les skills portant user-invocable: true.
  • Réécrit chaque description en une phrase courte plutôt que de recopier le frontmatter.

Limites

  • Chemin codé en dur (/usr/local/hal-9000) : le skill doit s'arrêter en dehors de ce dépôt.
  • Suppose que ./bin/hal sync existe et fonctionne ; aucune vérification préalable n'est décrite.
  • La réécriture des descriptions en ~10 mots reste heuristique et demande une relecture.
Quand l'utiliser

À utiliser après avoir ajouté, renommé ou supprimé un skill, ou modifié sa description, pour réaligner tous les fichiers qui le référencent.

Quand l'éviter

À ne pas utiliser hors du dépôt /usr/local/hal-9000, ni pour modifier le contenu d'un skill au lieu de ses métadonnées.

Analyse de sécurité

Sûr
Score qualité82/100

The skill is a repo-maintenance routine: it globs SKILL.md files, reads frontmatter, and rewrites markdown/JSON manifests. No network egress, no secret handling, no destructive commands, and shell access is pinned to a single subcommand (./bin/hal sync). The only notable surface is that it modifies its own settings.json and CLAUDE.md, but edits are constrained to Skill(...) allow-list entries and skill link definitions, so overall risk is low.

Points d'attention
  • •Edits dotfiles/.claude/settings.json (permissions.allow) and CLAUDE.md, which can affect the agent's own configuration — changes are scoped to Skill(...) entries only
  • •Hardcoded path /usr/local/hal-9000 with an explicit abort guard outside that directory
  • •Bash usage is narrowly restricted to ./bin/hal sync:* and is not used for arbitrary commands
Comment cette analyse est faite

Exemples

New skill added
I just created skills/pdf-tools/SKILL.md. Sync the skill registries so README, CLAUDE.md, settings.json and hal_dotfiles.json all pick it up.
Rename a skill
Rename the skill `lint-check` to `lint-runner` and update its description, then run sync-skills to fix every reference.
Remove a skill
I deleted the `old-scraper` skill folder — clean up all its entries across README.md, CLAUDE.md, settings.json and hal_dotfiles.json and re-run the sync.

name: sync-skills description: (hal-9000) Use when a skill in skills/ has its name or description changed, or is added or removed — syncs README.md, CLAUDE.md, settings.json, and hal_dotfiles.json context: fork user-invocable: true model: haiku allowed-tools:

  • Glob
  • Read
  • Edit
  • Bash(./bin/hal sync:*)

Instructions

IMPORTANT: Only use this skill in /usr/local/hal-9000. Otherwise, abort.

  1. Discover skills

    • Glob skills/*/SKILL.md in /usr/local/hal-9000 only
    • Extract name from each YAML frontmatter
    • Rewrite each description into one short sentence (~10 words max) saying what it does — no "Use when" triggers, no verbatim frontmatter copy

  2. Update README.md (the ### Agent Skills section)

    • Format: - [name](skills/name): description
    • Use the rewritten description from step 1
    • Add new skills, remove deleted skills, update changed descriptions
    • Preserve existing entry order; append new entries at end

  3. Update dotfiles/.claude/CLAUDE.md (the ## Skills section)

    • Format: - \name`: description`
    • Use the rewritten description from step 1
    • Add new skills, remove deleted skills, update changed descriptions
    • Preserve existing entry order; append new entries at end

  4. Update dotfiles/.claude/settings.json (the permissions.allow array)

    • Sync the Skill(...) entries to match discovered user-invocable skills
    • Only include skills with user-invocable: true in frontmatter
    • Format: "Skill(<name>)"
    • Add new skills, remove entries whose skill no longer exists
    • Preserve existing entry order; append new entries at end
    • Keep the entries in the same position block (between other tool entries)

  5. Update dotfiles/hal_dotfiles.json (the links array)

    • Format: {"dest": "{{HOME}}/.claude/skills/<name>/", "src": "{{REPO_ROOT}}/skills/<name>/"}
    • Add new skill dirs, remove entries whose "src" matches {{REPO_ROOT}}/skills/* but no longer has a matching skill
    • Preserve existing entry order; append new entries at end
    • Leave non-skill entries and copies array as-is

  6. Run ./bin/hal sync, then report what changed.

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/sync-skills-mm5t8be1/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/sync-skills-mm5t8be1' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/sync-skills-mm5t8be1/download' --output '.skill-downloads/sync-skills-mm5t8be1/SKILL.md.part' && mv '.skill-downloads/sync-skills-mm5t8be1/SKILL.md.part' '.skill-downloads/sync-skills-mm5t8be1/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.

Claude Code
test -f '.skill-downloads/sync-skills-mm5t8be1/SKILL.md' && test -s '.skill-downloads/sync-skills-mm5t8be1/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/sync-skills' && cp -R '.skill-downloads/sync-skills-mm5t8be1' '.claude/skills/sync-skills'

OpenSkills

OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.

Installation officielle d’OpenSkills
openskills install './.skill-downloads/sync-skills-mm5t8be1'

openskills read 'sync-skills-mm5t8be1'

La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.

Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.

openskills sync

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/sync-skills-mm5t8be1/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires

Configurer un canal de discussion avec SecretRefs

DevOps

Configurez des canaux de discussion avec des commandes non interactives, les secrets étant uniquement des SecretRefs. Couvre les étapes de collecte, modification, réparation et vérification.

Claude CodeCodexintermediateSûr 387,940
Skills Guide Bot

Enquêter sur les échecs CI de ClickHouse

DevOps

Investigue un échec CI de ClickHouse de bout en bout à partir d'une URL de PR ou de rapport S3. Récupère les tests échoués, classe flaky vs vraie régression, et cherche des issues/fixes existants.

Claude CodeadvancedSûr 49,516
Skills Guide Bot

Revue de PR Ansible

DevOps

Examine une PR Ansible selon le processus standardisé du projet, incluant la validation des changelogs, la couverture de tests et le suivi des commentaires.

Claude CodeintermediateSûr 70,491
Skills Guide Bot