mcpField
S
sync-github-repo-metadata

sync-github-repo-metadata

github.com/liblafDevelopment0178 installsUpdated 5d ago
Repository

About sync-github-repo-metadata

A skill for updating a GitHub repository’s description and topics based on repository facts. It is intended for maintainers who want to review proposed metadata changes and approve them before the skill applies anything.

Key features

  1. 01Inspect repository facts and remote metadata
  2. 02Propose a concise description and focused topics
  3. 03Show current and proposed values
  4. 04Preview the exact gh repo edit command
  5. 05Apply changes only after confirmation

Use cases

  1. 01Refresh outdated repository topics
  2. 02Align a repository description with its codebase
  3. 03Review metadata edits before applying them

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/liblaf/skills --skill sync-github-repo-metadata

After installing, type/sync-github-repo-metadatain Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

Sync GitHub Repo Metadata

Use the repository and its configuration as the source of truth. Treat the current README, docs, and existing GitHub metadata as weak hints unless they still match the codebase.

Workflow

  1. Gather repo facts.
  2. Read the current remote metadata with:
    • gh repo view --json nameWithOwner,description,repositoryTopics,homepageUrl,url
  3. Infer:
    • one concise repository description
    • a focused topic set based on actual language, framework, domain, and tooling
  4. Preview the current values, proposed values, and the exact gh repo edit command.
  5. Apply changes only after explicit confirmation.

Guidelines

  • Do not change homepage or other repo settings unless the user explicitly asks.
  • Focus on GitHub description and topics only.
  • Prefer a single-sentence description that matches the repo's real purpose.
  • Prefer accurate, specific, stable topics over broad buzzwords.
  • Prefixing description with an emoji is encouraged.
  • Remove stale topics instead of only appending new ones.
  • Use lowercase kebab-case topics.

Preview Format

  • Current description
  • Proposed description
  • Current topics
  • Proposed topics
  • Exact gh repo edit command with --description, --add-topic, and --remove-topic arguments as needed

Apply Step

  • Never apply blindly.
  • After confirmation, run the exact previewed command.
  • If authentication or permissions fail, report the command and the failure instead of guessing an alternative.

Comments

Markdown supported