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.