team-shinchan:manage-skills
npx machina-cli add skill seokan-jeong/team-shinchan/manage-skills --openclawMANDATORY EXECUTION - DO NOT SKIP
When this skill is invoked, execute immediately. Do not explain.
Step 1: Collect Changes
git status --porcelain && git diff --name-only HEAD~1
Exempt paths (not verification targets): .shinchan-docs/**, docs/**, WORKFLOW_STATE.yaml, tests/validate/**, node_modules/**, .git/**
Verification targets: agents/.md, skills//SKILL.md, hooks/*.md, CLAUDE.md, tests/** (except validators)
Step 2: Map Changes to Validators
| Changed Path | Verify Skill | Validators |
|---|---|---|
agents/*.md, agents/_shared/*.md | verify-agents | agent-schema, shared-refs |
skills/*/SKILL.md | verify-skills | skill-schema, skill-format, input-validation |
CLAUDE.md | verify-consistency | cross-refs, stage-matrix, debate-consistency |
docs/workflow-guide.md, hooks/*.md | verify-workflow | workflow-state-schema, error-handling, quick-fix-path |
agents/*-part-*.md | verify-workflow | part-numbering |
| Memory-related sections | verify-memory | memory-system |
| Any file creation/expansion | verify-budget | token-budget |
hooks/hooks.json, plugin.json | verify-hooks | hook-registration |
skills/*/SKILL.md, commands/*.md | verify-skills | skill-command-parity |
plugin.json, marketplace.json, README.md, CHANGELOG.md | verify-consistency | version-consistency |
Total: 17 validators across 7 verify-* skills.
Step 3: Report Coverage
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔧 [Skill Manager] Coverage Analysis
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 Changed files: {count}
✅ Covered: {file → verify-skill (validators)}
⚠️ Uncovered: {file → No matching skill}
📋 Run: cd "${CLAUDE_PLUGIN_ROOT}" && node tests/validate/index.js
Step 4: Gap Resolution
- Fits existing category: report which verify-* should add coverage
- New category needed: report to user with recommendation
- Should be exempt: suggest adding to exempt list
Prohibited
- Excluding
*.mdfrom analysis (they ARE the codebase) - Looking for
src/directories (markdown plugin) - Auto-creating verify-* skills without user approval
- Modifying validators in
tests/validate/
Success Criteria
All changed files analyzed, each mapped to verify-* skill, gaps identified, validator commands listed.
Source
git clone https://github.com/seokan-jeong/team-shinchan/blob/main/skills/manage-skills/SKILL.mdView on GitHub Overview
team-shinchan:manage-skills analyzes changes to ensure every modified file is covered by a verify-* skill and preserves the verification pipeline integrity. It maps changed paths to validators and surfaces coverage gaps for remediation.
How This Skill Works
Collects changes with git status and git diff, excluding exempt paths. Maps each changed path to the appropriate verify skill and validators (e.g., skill-schema, input-validation). Generates a coverage report and outlines gap resolutions.
When to Use It
- After a PR updates skills/*/SKILL.md to ensure coverage.
- When new file types are added that require new validators.
- During CI to catch unvalidated changes across agents, hooks, or docs.
- Before release to verify consistency across plugin assets.
- When a change might create gaps in verification coverage.
Quick Start
- Step 1: git status --porcelain && git diff --name-only HEAD~1
- Step 2: Map each changed path to the appropriate verify-* validators
- Step 3: Review the Coverage Report and address any gaps
Best Practices
- List all changed files before running analysis.
- Keep exempt paths updated to avoid noise.
- Review validator mappings for new or renamed files.
- Run coverage reports as part of PR checks.
- Document any gaps and recommended fixes in the PR description.
Example Use Cases
- PR updates skills/foo/SKILL.md; verify-skills maps to skill-schema and input-validation.
- CLAUDE.md changed; verify-consistency ensures cross-refs alignment.
- docs/workflow-guide.md touched; verify-workflow triggers workflow-state checks.
- hooks/hooks.json changed; verify-hooks validates hook-registration.
- tests/new-tests.md added; verify-budget handles token-budget coverage.
