skill-sync

Original：🇺🇸 English
Translated
2 scripts

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).

8installs
Sourceprowler-cloud/prowler
Added on

NPX Install

npx skill4agent add prowler-cloud/prowler skill-sync

Tags

Translated version includes tags in frontmatter
skill-syncmetadata-managementscript-automationagents-mdcli-tool

SKILL.md Content

View Translation Comparison →

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:
yaml
metadata:
  author: prowler-cloud
  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

ScopeUpdates
root
AGENTS.md
(repo root)
ui
ui/AGENTS.md
api
api/AGENTS.md
sdk
prowler/AGENTS.md
mcp_server
mcp_server/AGENTS.md
Skills can have multiple scopes: 
scope: [ui, api]

Usage

After Creating/Modifying a Skill

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

What It Does

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

Example

Given this skill metadata:
yaml
# skills/prowler-ui/SKILL.md
metadata:
  author: prowler-cloud
  version: "1.0"
  scope: [ui]
  auto_invoke: "Creating/modifying React components"
The sync script generates in 
ui/AGENTS.md
:
markdown
### Auto-invoke Skills

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

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

Commands

bash
# 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