Skip to content

refactor: rename maintenance skills to verb-first convention#43

Merged
Soul-Craft merged 1 commit into
mainfrom
claude/youthful-merkle
Apr 16, 2026
Merged

refactor: rename maintenance skills to verb-first convention#43
Soul-Craft merged 1 commit into
mainfrom
claude/youthful-merkle

Conversation

@Soul-Craft

Copy link
Copy Markdown
Owner

Summary

  • Rename /cache-clean/clean-cache, /security-audit/audit-security, /token-review/review-token for consistent action-then-object naming across all maintenance skills
  • Drop the empty skills/customize-buddy/ directory — a leftover artifact from the earlier /buddy-evolve refactor with no content or value
  • Fix a stale inline comment in skills/review-token/SKILL.md (caught by comment-reviewer during session review)

What changed and why

The three maintenance skills previously used noun-first names (cache-clean, security-audit, token-review) while all other skills in the project use verb-first names (buddy-evolve, sync-docs, run-tests, etc.). This rename makes the convention consistent.

All references updated across: CLAUDE.md, README.md, CONTRIBUTING.md, agent definitions (cache-reviewer, docs-reviewer, token-reviewer), skill cross-references (session-review, sync-docs), and the docs test path check.

The scripts/cache-clean.sh script name is intentionally unchanged — that's a shell script, not a skill.

Test plan

  • bash scripts/test-all.sh — 183/183 passed across all 6 tiers (smoke, unit, security, ui, snapshots, docs)
  • Docs tier specifically validates all skill directory paths, SKILL.md presence, and cross-references — 18/18 pass
  • Docs-reviewer agent confirmed no drift in CLAUDE.md or README.md
  • Comment-reviewer (Haiku) found and fixed one stale inline comment

🤖 Generated with Claude Code

Rename /cache-clean → /clean-cache, /security-audit → /audit-security,
/token-review → /review-token for consistent action-then-object naming.

Updates all references across CLAUDE.md, README.md, CONTRIBUTING.md,
agent definitions, skill cross-references, and the docs test path check.
Drops the empty skills/customize-buddy/ leftover from the earlier refactor.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

Local tests not yet uploaded

This repository runs macOS-dependent tests locally (not in CI) to keep
GitHub Actions costs down. Before this PR can merge, please:

  1. Run the full test suite on your macOS machine:
    scripts/test-all.sh
    
  2. Upload the results to GitHub:
    scripts/upload-test-results.sh
    

Results will appear either as a Check Run or a PR comment on this commit.
See CLAUDE.md for more detail on the testing architecture.

@Soul-Craft Soul-Craft merged commit 5734457 into main Apr 16, 2026
6 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant