skill-sync

Sync AGENTS.md Auto-invoke sections with skill metadata from SKILL.md frontmatter.

1|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/BrunoAlan/agents-skills --skill skill-sync-brunoalan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-sync
Source: https://github.com/BrunoAlan/agents-skills/tree/main/skills/skill-sync
Command: npx skills add https://github.com/BrunoAlan/agents-skills --skill skill-sync-brunoalan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill keeps AGENTS.md Auto-invoke sections up to date whenever skill metadata changes.

Core Features & Use Cases

  • Reads all skills' SKILL.md files to extract metadata.scope and metadata.auto_invoke.
  • Regenerates and writes Auto-invoke tables into each dedicated AGENTS.md (root/ui/api/sdk/mcp_server) to reflect current mappings.
  • Supports dry-run mode and scoped updates for safe, idempotent maintenance.

Quick Start

Run the script to synchronize all AGENTS.md auto-invoke sections: ./skills/skill-sync/assets/sync.sh

Frequently Asked Questions about skill-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep AGENTS.md auto-invoke sections in sync with skill metadata changes?▼

To keep AGENTS.md auto-invoke sections in sync, this automation parses each skill's SKILL.md YAML frontmatter to extract metadata.scope and metadata.auto_invoke, then regenerates per-scope auto-invoke tables across all scopes.

How do I update AGENTS.md auto-invoke tables across multiple project scopes?▼

You can update AGENTS.md auto-invoke tables by running the sync bash script, which reads SKILL.md frontmatter metadata and rewrites the auto-invoke sections for root, ui, api, sdk, and mcp_server scopes.

Can I preview AGENTS.md auto-invoke updates before applying metadata changes?▼

Yes, you can preview AGENTS.md auto-invoke updates using the supported dry-run mode, which evaluates SKILL.md frontmatter metadata changes and shows the regenerated auto-invoke tables without writing to the files.

What is the best way to automate AGENTS.md regeneration from SKILL.md YAML frontmatter?▼

The best way to automate AGENTS.md regeneration is using a bash script that parses YAML frontmatter from SKILL.md files to extract scope and auto_invoke metadata, ensuring idempotent maintenance of auto-invoke sections.

Does AGENTS.md synchronization work with scoped updates for specific directories like api or sdk?▼

Yes, AGENTS.md synchronization supports scoped updates, allowing you to target specific directories like api or sdk by reading their respective SKILL.md frontmatter and regenerating only the relevant auto-invoke tables.

Why are my AGENTS.md auto-invoke sections out of date after modifying skill metadata?▼

AGENTS.md auto-invoke sections become outdated when SKILL.md frontmatter metadata changes manually, requiring a synchronization script to parse the updated scope and auto_invoke fields and rewrite the tables.