Notre avis

Synchronise les métadonnées des compétences dans les sections Auto-invoke des fichiers AGENTS.md.

Points forts

Met à jour automatiquement les tables Auto-invoke après modification d'une compétence.
Supporte plusieurs portées (root, ui, api, sdk, mcp_server).
Offre un mode dry-run pour prévisualiser les changements.
Utilise un script simple pour une intégration facile.

Limites

Nécessite que chaque compétence ait des métadonnées scope et auto_invoke correctement définies.
Ne fonctionne que dans une structure de répertoires spécifique (skills/*/SKILL.md).
Requiert une exécution manuelle du script de synchronisation.

Quand l'utiliser

Utilisez cette compétence après avoir créé ou modifié une compétence pour mettre à jour les tables Auto-invoke dans AGENTS.md.

Quand l'éviter

Évitez cette compétence si vos compétences n'ont pas besoin d'apparaître dans les sections Auto-invoke ou si vous n'utilisez pas la structure AGENTS.md.

Exemples

Run sync after skill update

I just updated the metadata for the 'example-ui' skill. Run the sync script to update AGENTS.md auto-invoke tables.

Dry-run sync

Run the sync script with --dry-run to show what changes would be made to AGENTS.md files.

Sync only UI scope

Sync only the UI scope AGENTS.md by running the sync script with --scope ui.

name: skill-sync description: > Syncs skill metadata to AGENTS.md Auto-invoke sections. Trigger: When updating skill metadata (metadata.scope/metadata.auto_invoke), regenerating Auto-invoke tables, or running ./skills/skill-sync/assets/sync.sh (including --dry-run/--scope). license: Apache-2.0 metadata: author: Alan version: "1.0" scope: [root] auto_invoke: - "After creating/modifying a skill" - "Regenerate AGENTS.md Auto-invoke tables (sync.sh)" - "Troubleshoot why a skill is missing from AGENTS.md auto-invoke" allowed-tools: Read, Edit, Write, Glob, Grep, Bash

Purpose

Keeps AGENTS.md Auto-invoke sections in sync with skill metadata. When you create or modify a skill, run the sync script to automatically update all affected AGENTS.md files.

Required Skill Metadata

Each skill that should appear in Auto-invoke sections needs these fields in metadata.

auto_invoke can be either a single string or a list of actions:

metadata:
  author: Alan
  version: "1.0"
  scope: [ui]                                    # Which AGENTS.md: ui, api, sdk, root

  # Option A: single action
  auto_invoke: "Creating/modifying components"

  # Option B: multiple actions
  # auto_invoke:
  #   - "Creating/modifying components"
  #   - "Refactoring component folder placement"

Scope Values

| Scope | Updates | |-------|---------| | root | AGENTS.md (repo root) | | ui | ui/AGENTS.md | | api | api/AGENTS.md | | sdk | sdk/AGENTS.md | | mcp_server | mcp_server/AGENTS.md |

Skills can have multiple scopes: scope: [ui, api]

Usage

After Creating/Modifying a Skill

./skills/skill-sync/assets/sync.sh

What It Does

Reads all skills/*/SKILL.md files
Extracts metadata.scope and metadata.auto_invoke
Generates Auto-invoke tables for each AGENTS.md
Updates the ### Auto-invoke Skills section in each file

Example

Given this skill metadata:

# skills/example-ui/SKILL.md
metadata:
  author: Alan
  version: "1.0"
  scope: [ui]
  auto_invoke: "Creating/modifying React components"

The sync script generates in ui/AGENTS.md:

### Auto-invoke Skills

When performing these actions, ALWAYS invoke the corresponding skill FIRST:

| Action | Skill |
|--------|-------|
| Creating/modifying React components | `example-ui` |

Commands

# Sync all AGENTS.md files
./skills/skill-sync/assets/sync.sh

# Dry run (show what would change)
./skills/skill-sync/assets/sync.sh --dry-run

# Sync specific scope only
./skills/skill-sync/assets/sync.sh --scope ui

Checklist After Modifying Skills

[ ] Added metadata.scope to new/modified skill
[ ] Added metadata.auto_invoke with action description
[ ] Ran ./skills/skill-sync/assets/sync.sh
[ ] Verified AGENTS.md files updated correctly

Synchronisation des métadonnées de compétences

Recommandé pour