Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Search & research

readme-sync

Regenerate catalog counts, layout claims, and README summaries from canonical sources. Run after adding, removing, or renaming skills, commands, or bundles.

shipshitdev · AI review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add shipshitdev/skills --skill readme-sync

About this skill


name: readme-sync description: | Regenerate catalog counts, layout claims, and README summaries from canonical sources. Run after adding, removing, or renaming skills, commands, or bundles. metadata: internal: true version: "1.1.0" tags: "readme, sync, maintenance, automation"

README and Catalog Sync

Regenerate catalog.json and every marked count/layout summary from the actual skill, command, bundle, and tracked-path sources.

When to Run

  • After adding new skills
  • After removing or renaming skills
  • After adding or removing commands or bundles
  • After importing skills from external repos
  • When any catalog count or directory claim does not match the repository

Process

1. Generate the Catalog and Documentation Blocks

bun run catalog:generate

The generator derives:

  • skills from skills/*/SKILL.md;
  • commands from commands/*.md;
  • bundles from scripts/plugin-categories.json;
  • plugins as skills plus bundles;
  • top-level layout from git ls-files.

It writes the single generated source catalog.json, then updates marked blocks in README.md, AGENTS.md, and memory/architecture docs plus the package description. Do not edit text between catalog-*:start and catalog-*:end markers manually.

2. Validate Without Writing

bun run catalog:check

The lightweight repository validator also runs this check, and CI regenerates the catalog and fails if any generated file changes.

Safety

  • Preserve prose outside generated markers.
  • Never infer counts from README text.
  • Never add a top-level path to the generated layout unless it is tracked.
  • Review catalog.json and generated documentation diffs before committing.