skill-sync

Synchronize SKILL.md metadata into GEMINI.md auto-invoke tables.

Updated Aug 17, 2025
One-click install
npx skills add https://github.com/global-ministries/global-connect --skill skill-sync-global-ministries
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-sync
Source: https://github.com/global-ministries/global-connect/tree/main/.agent/skills/skill-sync
Command: npx skills add https://github.com/global-ministries/global-connect --skill skill-sync-global-ministries

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill ensures that your AI's documentation (GEMINI.md) accurately reflects the available skills and their intended uses, preventing outdated or missing information.

Core Features & Use Cases

  • Automated Documentation Updates: Automatically generates and updates "Auto-invoke Skills" tables in GEMINI.md files based on SKILL.md metadata.
  • Metadata Synchronization: Extracts scope and auto_invoke fields from all SKILL.md files across the repository.
  • Use Case: After adding a new skill or modifying an existing one, running this sync script ensures that the relevant GEMINI.md file is updated to include the new skill in its auto-invoke section, making it discoverable and usable by the AI.

Quick Start

Run the sync script to update all GEMINI.md files with the latest skill metadata.

Frequently Asked Questions about skill-sync

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

FAQPage Schema
How do I sync skill metadata to GEMINI.md automatically?

To sync skill metadata to GEMINI.md, run the script to scan all `SKILL.md` files, extract `metadata.scope` and `metadata.auto_invoke` fields, and generate or update auto-invoke tables in your repository's `GEMINI.md` files.

What is the best way to update auto-invoke tables in GEMINI.md after adding a new skill?

The best way to update auto-invoke tables is running this sync tool, which scans all `skills/*/SKILL.md` files to extract metadata and updates the relevant `GEMINI.md` sections with the new skill's information.

Can I preview changes before updating GEMINI.md files?

Yes, you can preview changes before updating `GEMINI.md` files by executing the script in dry-run mode, allowing you to review the generated auto-invoke tables without modifying any documentation files.

Does the metadata sync support filtering by scope?

Yes, the metadata sync supports filtering by scope, allowing you to target specific `metadata.scope` fields from `SKILL.md` files to selectively update only the relevant `GEMINI.md` auto-invoke sections.

Why is my newly added skill not discoverable in GEMINI.md?

Your newly added skill is not discoverable in `GEMINI.md` because the auto-invoke tables are outdated; running this sync script extracts the latest `metadata.auto_invoke` from `SKILL.md` and updates the documentation.