Agent skill
update-refs
Update naming and documentation references across the Claude CodePro codebase. Use when renaming features, updating descriptions, changing terminology, or ensuring consistency after modifying commands, skills, or workflows. Triggers on "update references", "rename X to Y across codebase", "sync documentation", or "update all mentions of X".
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/update-refs
SKILL.md
Update References
Ensure naming and documentation consistency across all codebase locations.
Checklist
When updating terminology, feature names, or descriptions, check ALL locations:
1. User-Facing Messages
| Location | What to Check |
|---|---|
ccp/banner.py |
Welcome banner text, feature descriptions |
ccp/cli.py |
CCP CLI help text and messages |
installer/cli.py |
Installer CLI help text, prompts |
installer/steps/finalize.py |
Post-install instructions |
installer/ui.py |
UI banner and status messages |
2. Documentation & Site
| Location | What to Check |
|---|---|
README.md |
Feature descriptions, usage examples, quick start |
docs/site/index.html |
SEO meta tags, page title, descriptions |
docs/site/src/components/*.tsx |
Marketing site content (WhatsInside, etc.) |
3. Package & Install
| Location | What to Check |
|---|---|
pyproject.toml |
Package name, description, metadata |
install.sh |
Shell installer script messages |
ccp/__init__.py |
Package docstring |
4. Claude Configuration
| Location | What to Check |
|---|---|
.claude/commands/*.md |
Command descriptions in frontmatter |
.claude/skills/*/SKILL.md |
Skill descriptions in frontmatter |
.claude/rules/standard/*.md |
Rule references to features |
.claude/rules/custom/*.md |
Project-specific rule content |
.claude/hooks/*.py |
Hook script messages |
5. Bundled Installer Copy
| Location | What to Check |
|---|---|
.claude/installer/installer/*.py |
Bundled installer copy (mirrors installer/) |
Workflow
-
Search first - Use grep to find all occurrences:
bashgrep -r "old term" --include="*.md" --include="*.py" --include="*.tsx" . -
Update systematically - Work through checklist above
-
Verify consistency - Search again to confirm no misses:
bashgrep -r "old term" . | grep -v node_modules | grep -v .git
Common Updates
| Change Type | Key Locations |
|---|---|
| Command rename | commands/.md, README.md, banner.py, rules/.md |
| Skill rename | skills/*/SKILL.md, README.md, WhatsInside.tsx |
| Feature description | banner.py, README.md, site components, index.html |
| Workflow change | commands/.md, rules/.md, README.md |
| Package rename | pyproject.toml, install.sh, ccp/init.py, README.md |
| Installer message | installer/.py, .claude/installer/installer/.py |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?