skill-sync

Syncs SKILL.md metadata into AGENTS.md auto-invoke sections for NX monorepos.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/johnnystefan/test-saas-business --skill skill-sync-johnnystefan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-sync
Source: https://github.com/johnnystefan/test-saas-business/tree/main/skills/skill-sync
Command: npx skills add https://github.com/johnnystefan/test-saas-business --skill skill-sync-johnnystefan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Maintaining AGENTS.md Auto-invoke sections by hand after every skill change leads to stale documentation and missed automations, so this skill automates the synchronization of those tables with each SKILL.md's metadata.

Core Features & Use Cases

  • Metadata scanning: Parses every SKILL.md to capture metadata.scope and metadata.auto_invoke entries for each skill.
  • Scope-aware updates: Maps scopes to their AGENTS.md files, sorts actions alphabetically, and rewrites the Auto-invoke Skills section with dry-run and scope filtering options.
  • Use Case: After defining metadata for a new skill, run the sync script to update all impacted AGENTS.md files without manually editing each table.

Quick Start

Run the sync.sh script under skills/skill-sync/assets after editing any SKILL.md so AGENTS.md auto-invoke tables refresh with new metadata.

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 tables synced with SKILL.md metadata?

You can keep AGENTS.md auto-invoke tables synced by running a bash script that parses every SKILL.md, aggregates metadata.scope and metadata.auto_invoke entries, and rewrites the matching AGENTS.md sections automatically.

Why does my AGENTS.md documentation get stale after updating skills?

AGENTS.md documentation gets stale because manually editing auto-invoke tables after every skill change is error-prone. Automating the synchronization reads updated SKILL.md metadata and rewrites the tables to prevent missed automations.

How to update NX monorepo AGENTS.md files after adding a new skill?

To update NX monorepo AGENTS.md files after adding a skill, run the sync script. It maps the new skill's metadata.scope to the correct AGENTS.md target, sorts actions alphabetically, and rewrites the Auto-invoke Skills section.

Can I preview AGENTS.md auto-invoke changes before applying them?

Yes, you can preview AGENTS.md auto-invoke changes using the dry-run control. This allows you to verify the aggregated and sorted actions from your SKILL.md metadata before the script rewrites the actual AGENTS.md files.

How do I filter AGENTS.md auto-invoke updates by scope?

You can filter AGENTS.md auto-invoke updates by scope using the scope filter control. This limits the synchronization process to only rewrite the AGENTS.md files matching the targeted metadata.scope values from your SKILL.md files.