From skill-maintainer
Full maintenance pass for a skills repo: pull upstream docs, sync tracked source repos, run quality checks, and review best practices for updates. Use when user says "maintain", "maintenance pass", "check upstream", "pull sources", "review best practices", "run maintenance". Invoke with /skill-maintainer:maintain.
How this skill is triggered — by the user, by Claude, or both
Slash command
/skill-maintainer:maintainThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Run each phase in order. Report results after each phase. Continue even if one phase has no changes.
Run each phase in order. Report results after each phase. Continue even if one phase has no changes.
If skill-maintain CLI is available:
skill-maintain sources
If CLI is not available, check for tracked repos in .skill-maintainer/config.json under tracked_repos. For each repo path that exists:
git -C <path> rev-parse HEADgit -C <path> pull --ff-onlygit -C <path> log --oneline <old>..<new>) or UP_TO_DATE.If no config file exists, skip this phase and note "no .skill-maintainer/config.json found -- skip source pull (run /skill-maintainer:init-maintenance to set up)".
If skill-maintain CLI is available:
skill-maintain upstream
If CLI is not available, check .skill-maintainer/config.json for llms_full_url and upstream_urls. Fetch the llms-full.txt URL using WebFetch, split by Source: <url> delimiters, and compare each watched page's content against stored hashes in .skill-maintainer/state/upstream_hashes.json.
If no config file exists, skip and note "no config -- skip upstream check".
If skill-maintain CLI is available:
skill-maintain quality
If CLI is not available, perform the checks manually. For every SKILL.md found in the repo:
name and description fieldsname is kebab-case, matches directory name.md files only), divide by 4metadata.last_verified present and within 30 days of todayOutput a table with one row per skill: name, valid, tokens, lines, days since verified, description quality.
After all three phases:
references/best_practices.md (bundled with this plugin) or .skill-maintainer/best_practices.md (if present in the repo)best_practices.md needs updates based on:
best_practices.md -- always show proposed changes and wait for approvalnpx claudepluginhub fblissjr/fb-claude-skills --plugin skill-maintainerGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.