skill-sync

Sync skill metadata from SKILL.md frontmatter into AGENTS.md auto-invoke sections.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/arelben/Goals-Dashboard --skill skill-sync-arelben
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-sync
Source: https://github.com/arelben/Goals-Dashboard/tree/main/.agent/skills/skill-sync
Command: npx skills add https://github.com/arelben/Goals-Dashboard --skill skill-sync-arelben

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

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.

Core Features & Use Cases

  • Reads all SKILL.md files under skills, extracts metadata.scope and metadata.auto_invoke, and aggregates per scope.
  • Updates the corresponding AGENTS.md with a consolidated Auto-invoke table, with support for dry-run and scope filtering.
  • Works across repo scopes (root, ui, api, sdk, mcp_server) to ensure consistent documentation governance.

Quick Start

Execute the sync script to propagate skill metadata changes to all AGENTS.md files.

Frequently Asked Questions about skill-sync

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

FAQPage Schema
How do I automatically sync AGENTS.md auto-invoke sections with skill metadata?

You can automatically sync AGENTS.md auto-invoke sections by running a script that reads all SKILL.md frontmatter to collect name, scope, and auto_invoke data, then updates the corresponding AGENTS.md files accordingly.

What is the best way to update AGENTS.md files when skill metadata changes?

The best way to update AGENTS.md files when skill metadata changes is to execute a sync script that aggregates per scope and updates the relevant AGENTS.md files with a consolidated Auto-invoke table.

Can I filter which repository scopes are updated during an AGENTS.md sync?

Yes, you can filter which repository scopes are updated during an AGENTS.md sync because the process supports scope filtering across root, ui, api, sdk, and mcp_server directories.

Does the AGENTS.md sync script support dry-run mode to preview metadata changes?

Yes, the AGENTS.md sync script supports dry-run mode, allowing you to preview how the consolidated Auto-invoke table will be updated in the relevant files before committing any changes.

Why are my AGENTS.md Auto-invoke sections out of date after modifying SKILL.md frontmatter?

Your AGENTS.md Auto-invoke sections are out of date because modifying SKILL.md frontmatter requires you to manually run the sync script to propagate the updated metadata.scope and metadata.auto_invoke values.

How do I consolidate auto_invoke settings from multiple SKILL.md files into one table?

You consolidate auto_invoke settings by running the sync script, which reads all SKILL.md files under the skills directory, extracts the metadata, and aggregates the auto_invoke settings per scope into a consolidated table.