| name | skill-propagator |
| description | Propagates skill metadata to AGENTS.md Auto-invoke sections. Trigger: When updating skill metadata (metadata.scope/metadata.auto_invoke), regenerating Auto-invoke tables, or running skill-propagator/assets/propagate.sh (including --dry-run/--scope).
|
| license | Apache-2.0 |
| metadata | {"author":"Victor Arias [Based on Pablo Lozano's [skill-propagator](https://github.com/Pablo-Lozano-Gil/battletested-agent-skills/tree/main/skill-propagator), licensed under Apache-2.0]","version":"1.0","scope":["root"],"auto_invoke":["After creating/modifying a skill","Regenerate AGENTS.md Auto-invoke tables (propagate.sh)","Troubleshoot why a skill is missing from AGENTS.md auto-invoke"]} |
| allowed-tools | Read, Edit, Write, Glob, Grep, Bash |
Skill Propagator
Purpose
Keeps AGENTS.md and README.md Auto-invoke sections in sync with skill metadata. When you create or modify a skill, run the propagate 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: {Author name}
version: "1.0"
scope: [ui]
auto_invoke: "Creating/modifying components"
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 | {project-name}/AGENTS.md |
mcp_server | mcp_server/AGENTS.md |
db | db/AGENTS.md |
Skills can have multiple scopes: scope: [ui, api]
Usage
After Creating/Modifying a Skill
skill-propagator/assets/propagate.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
- Generates Auto-invoke tables for the skill folder README.md
- Updates the
### Auto-invoke Skills section in each file
Example
Given this skill metadata:
metadata:
author: Pablo Lozano
version: "1.0"
scope: [ui]
auto_invoke: "Creating/modifying ASTRO 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 ASTRO components | `astro-ui` |
Commands
skill-propagator/assets/propagate.sh
skill-propagator/assets/propagate.sh --dry-run
./.agent/skills/skill-propagator/assets/propagate.sh --scope ui
Checklist After Modifying Skills
