All skills
Skillintermediate

Consistent `ce-` Prefix for All Skills and Agents

As the Claude Code plugin ecosystem grows, generic skill names like `setup`, `plan`, `review`, and `frontend-design` collide when users have multiple plugins installed. Typing `/plan` surfaces every plugin's plan skill, forcing users to scan descriptions. Agent names also collide across plugins — generic names like `adversarial-reviewer` or `security-reviewer` are common enough that multiple plugi

Claude Code Knowledge Pack7/10/2026

Overview

Consistent ce- Prefix for All Skills and Agents

Problem Frame

As the Claude Code plugin ecosystem grows, generic skill names like setup, plan, review, and frontend-design collide when users have multiple plugins installed. Typing /plan surfaces every plugin's plan skill, forcing users to scan descriptions. Agent names also collide across plugins — generic names like adversarial-reviewer or security-reviewer are common enough that multiple plugins could define them. The compound-engineering plugin currently uses an inconsistent mix: 8 core workflow skills have a ce: colon prefix, while 33 others have no prefix at all. Agents use verbose 3-segment references (compound-engineering:<category>:<agent-name>) that are cumbersome and can be simplified now that agents will have a unique ce- prefix. This creates collision risk, a confusing naming taxonomy, and unnecessarily verbose agent references.

Standardizing on a ce- hyphen prefix for all owned skills and agents eliminates collisions, creates a consistent namespace, simplifies agent references, and removes the colon character that requires filesystem sanitization on Windows.

Related: GitHub Issue #337

Requirements

When doing renames of files and folders, you are required to use git mv whenever possible for simplicity and explicit intent and history preservation. You can fallback provided you notify when it happens and why.

Naming Rules

  • R1. All compound-engineering-owned skills and agents adopt a ce- hyphen prefix
  • R2. Skills currently using ce: colon prefix change to ce- hyphen prefix (e.g., ce:plan -> ce-plan)
  • R3. Skills and Agents currently without a prefix get ce- prepended (e.g., setup -> ce-setup, frontend-design -> ce-frontend-design, repo-research-analyst -> ce-repo-research-analyst)
  • R4. git-* skills replace the git- prefix with ce- (e.g., git-commit -> ce-commit, git-worktree -> ce-worktree)
  • R5. report-bug-ce normalizes to ce-report-bug (drops redundant suffix)

Exclusions

  • R6. agent-browser and rclone are excluded (sourced from upstream, not our skills)
  • R7. lfg and slfg are excluded from renaming (short memorable workflow entry points), but their internal skill invocations must be updated per R12

Propagation

  • R8. The skill and agent frontmatter name: field must match after rename (no more colon-vs-hyphen divergence). Directories need to reflect the new names as well when applicable.
  • R9. All cross-references updated: skill-to-skill invocations (/ce:plan -> /ce-plan), fully-qualified references (/compound-engineering:todo-resolve -> /compound-engineering:ce-todo-resolve), Skill("compound-engineering:...") programmatic invocations, prose mentions, skill description: frontmatter fields, and intra-skill path references (${CLAUDE_PLUGIN_ROOT}/skills/<old-name>/...)
  • R10. Active documentation updated: root README, plugin README, AGENTS.md. Note: the AGENTS.md "Why ce:?" rationale section (lines 53-60) needs a conceptual rewrite explaining the ce- convention, not just find-and-replace. Historical docs in docs/ (past brainstorms, plans, solutions) are left as-is -- they are records of past decisions.
  • R11. Agent prompt files updated where they reference skill names.
  • R11b. Skill prompt files updated where they reference Agent names.
  • R11c. Agent references drop the compound-engineering: plugin prefix and keep the category. The agent name itself gets the ce- prefix. (e.g. compound-engineering:review:adversarial-reviewer -> review:ce-adversarial-reviewer)
  • R12. lfg and slfg orchestration chains updated to use new skill names (lfg/slfg themselves are not renamed per R7, but their internal skill and agent invocations must reflect new names)
  • R13. Converter infrastructure preserved: sanitizePathName() and colon-handling logic stays as future protection, not removed. Add a test assertion that no skill name: field contains a colon, so the sanitizer is defense-in-depth rather than a silent workaround.
  • R17. Codex converter's isCanonicalCodexWorkflowSkill() and toCanonicalWorkflowSkillName() in src/converters/claude-to-codex.ts updated to match ce- prefix pattern (currently hardcodes ce: prefix check). Related test fixtures in tests/codex-converter.test.ts and tests/codex-writer.test.ts updated accordingly.

Testing

  • R14. Path sanitization tests updated to reflect new naming (collision detection still works)
  • R15. bun test passes after all changes
  • R16. bun run release:validate passes after all changes
  • R18. Converter test fixtures that hardcode ce:plan etc. updated to ce-plan where they test compound-engineering plugin behavior. Fixtures testing abstract colon-handling for other plugins may remain.
  • R19. Sanity check and for every skill and agent name, grep to confirm new names are correct and old names do not persist except in historical planning, requirements, etc docs.

Complete Rename Map

Excluded (no change) - 4 skills

Current NameReason
agent-browserExternal/upstream
rcloneExternal/upstream
lfgException (memorable name)
slfgException (memorable name)

ce: -> ce- (frontmatter only, dirs already match) - 8 skills

Current NameNew NameDir Rename?
ce:brainstormce-brainstormNo
ce:compoundce-compoundNo
ce:compound-refreshce-compound-refreshNo
ce:ideatece-ideateNo
ce:plance-planNo
ce:reviewce-reviewNo
ce:workce-workNo
ce:work-betace-work-betaNo

git-* -> ce-* (replace prefix) - 4 skills

Current NameNew NameDir Rename
git-clean-gone-branchesce-clean-gone-branchesgit-clean-gone-branches/ -> ce-clean-gone-branches/
git-commitce-commitgit-commit/ -> ce-commit/
git-commit-push-prce-commit-push-prgit-commit-push-pr/ -> ce-commit-push-pr/
git-worktreece-worktreegit-worktree/ -> ce-worktree/

Special normalization - 1 skill

Current NameNew NameDir Rename
report-bug-cece-report-bugreport-bug-ce/ -> ce-report-bug/

Standard prefix addition - 24 skills

Current NameNew NameDir Rename
agent-native-architecturece-agent-native-architectureagent-native-architecture/ -> ce-agent-native-architecture/
agent-native-auditce-agent-native-auditagent-native-audit/ -> ce-agent-native-audit/
andrew-kane-gem-writerce-andrew-kane-gem-writerandrew-kane-gem-writer/ -> ce-andrew-kane-gem-writer/
changelogce-changelogchangelog/ -> ce-changelog/
claude-permissions-optimizerce-claude-permissions-optimizerclaude-permissions-optimizer/ -> ce-claude-permissions-optimizer/
deploy-docsce-deploy-docsdeploy-docs/ -> ce-deploy-docs/
dhh-rails-stylece-dhh-rails-styledhh-rails-style/ -> ce-dhh-rails-style/
document-reviewce-document-reviewdocument-review/ -> ce-document-review/
dspy-rubyce-dspy-rubydspy-ruby/ -> ce-dspy-ruby/
every-style-editorce-every-style-editorevery-style-editor/ -> ce-every-style-editor/
feature-videoce-feature-videofeature-video/ -> ce-feature-video/
frontend-designce-frontend-designfrontend-design/ -> ce-frontend-design/
gemini-imagegence-gemini-imagegengemini-imagegen/ -> ce-gemini-imagegen/
onboardingce-onboardingonboarding/ -> ce-onboarding/
orchestrating-swarmsce-orchestrating-swarmsorchestrating-swarms/ -> ce-orchestrating-swarms/
proofce-proofproof/ -> ce-proof/
reproduce-bugce-reproduce-bugreproduce-bug/ -> ce-reproduce-bug/
resolve-pr-feedbackce-resolve-pr-feedbackresolve-pr-feedback/ -> ce-resolve-pr-feedback/
setupce-setupsetup/ -> ce-setup/
test-browserce-test-browsertest-browser/ -> ce-test-browser/
test-xcodece-test-xcodetest-xcode/ -> ce-test-xcode/
todo-createce-todo-createtodo-create/ -> ce-todo-create/
todo-resolvece-todo-resolvetodo-resolve/ -> ce-todo-resolve/
todo-triagece-todo-triagetodo-triage/ -> ce-todo-triage/

Total: 37 skills renamed, 4 excluded (41 skills total)

Agent renames - 49 agents

All agents are renamed with ce- prefix within their existing category subdirs. The compound-engineering: plugin prefix is dropped from references, keeping the <category>:ce-<agent-name> format. Category subdirs are preserved for organization.

Current FileNew FileOld ReferenceNew Reference
agents/design/design-implementation-reviewer.mdagents/design/ce-design-implementation-reviewer.mdcompound-engineering:design:design-implementation-reviewerdesign:ce-design-implementation-reviewer
agents/design/design-iterator.mdagents/design/ce-design-iterator.mdcompound-engineering:design:design-iteratordesign:ce-design-iterator
agents/design/figma-design-sync.mdagents/design/ce-figma-design-sync.mdcompound-engineering:design:figma-design-syncdesign:ce-figma-design-sync
agents/docs/ankane-readme-writer.mdagents/docs/ce-ankane-readme-writer.mdcompound-engineering:docs:ankane-readme-writerdocs:ce-ankane-readme-writer
agents/document-review/adversarial-document-reviewer.mdagents/document-review/ce-adversarial-document-reviewer.mdcompound-engineering:document-review:adversarial-document-reviewerdocument-review:ce-adversarial-document-reviewer
agents/document-review/coherence-reviewer.mdagents/document-review/ce-coherence-reviewer.mdcompound-engineering:document-review:coherence-reviewerdocument-review:ce-coherence-reviewer
agents/document-review/design-lens-reviewer.mdagents/document-review/ce-design-lens-reviewer.mdcompound-engineering:document-review:design-lens-reviewerdocument-review:ce-design-lens-reviewer
agents/document-review/feasibility-reviewer.mdagents/document-review/ce-feasibility-reviewer.mdcompound-engineering:document-review:feasibility-reviewerdocument-review:ce-feasibility-reviewer
agents/document-review/product-lens-reviewer.mdagents/document-review/ce-product-lens-reviewer.mdcompound-engineering:document-review:product-lens-reviewerdocument-review:ce-product-lens-reviewer
agents/document-review/scope-guardian-reviewer.mdagents/document-review/ce-scope-guardian-reviewer.mdcompound-engineering:document-review:scope-guardian-reviewerdocument-review:ce-scope-guardian-reviewer
agents/document-review/security-lens-reviewer.mdagents/document-review/ce-security-lens-reviewer.mdcompound-engineering:document-review:security-lens-reviewerdocument-review:ce-security-lens-reviewer
agents/research/best-practices-researcher.mdagents/research/ce-best-practices-researcher.mdcompound-engineering:research:best-practices-researcherresearch:ce-best-practices-researcher
agents/research/framework-docs-researcher.mdagents/research/ce-framework-docs-researcher.mdcompound-engineering:research:framework-docs-researcherresearch:ce-framework-docs-researcher
agents/research/git-history-analyzer.mdagents/research/ce-git-history-analyzer.mdcompound-engineering:research:git-history-analyzerresearch:ce-git-history-analyzer
agents/research/issue-intelligence-analyst.mdagents/research/ce-issue-intelligence-analyst.mdcompound-engineering:research:issue-intelligence-analystresearch:ce-issue-intelligence-analyst
agents/research/learnings-researcher.mdagents/research/ce-learnings-researcher.mdcompound-engineering:research:learnings-researcherresearch:ce-learnings-researcher
agents/research/repo-research-analyst.mdagents/research/ce-repo-research-analyst.mdcompound-engineering:research:repo-research-analystresearch:ce-repo-research-analyst
agents/review/adversarial-reviewer.mdagents/review/ce-adversarial-reviewer.mdcompound-engineering:review:adversarial-reviewerreview:ce-adversarial-reviewer
agents/review/agent-native-reviewer.mdagents/review/ce-agent-native-reviewer.mdcompound-engineering:review:agent-native-reviewerreview:ce-agent-native-reviewer
agents/review/api-contract-reviewer.mdagents/review/ce-api-contract-reviewer.mdcompound-engineering:review:api-contract-reviewerreview:ce-api-contract-reviewer
agents/review/architecture-strategist.mdagents/review/ce-architecture-strategist.mdcompound-engineering:review:architecture-strategistreview:ce-architecture-strategist
agents/review/cli-agent-readiness-reviewer.mdagents/review/ce-cli-agent-readiness-reviewer.mdcompound-engineering:review:cli-agent-readiness-reviewerreview:ce-cli-agent-readiness-reviewer
agents/review/cli-readiness-reviewer.mdagents/review/ce-cli-readiness-reviewer.mdcompound-engineering:review:cli-readiness-reviewerreview:ce-cli-readiness-reviewer
agents/review/code-simplicity-reviewer.mdagents/review/ce-code-simplicity-reviewer.mdcompound-engineering:review:code-simplicity-reviewerreview:ce-code-simplicity-reviewer
agents/review/correctness-reviewer.mdagents/review/ce-correctness-reviewer.mdcompound-engineering:review:correctness-reviewerreview:ce-correctness-reviewer
agents/review/data-integrity-guardian.mdagents/review/ce-data-integrity-guardian.mdcompound-engineering:review:data-integrity-guardianreview:ce-data-integrity-guardian
agents/review/data-migration-expert.mdagents/review/ce-data-migration-expert.mdcompound-engineering:review:data-migration-expertreview:ce-data-migration-expert
agents/review/data-migrations-reviewer.mdagents/review/ce-data-migrations-reviewer.mdcompound-engineering:review:data-migrations-reviewerreview:ce-data-migrations-reviewer
agents/review/deployment-verification-agent.mdagents/review/ce-deployment-verification-agent.mdcompound-engineering:review:deployment-verification-agentreview:ce-deployment-verification-agent
agents/review/dhh-rails-reviewer.mdagents/review/ce-dhh-rails-reviewer.mdcompound-engineering:review:dhh-rails-reviewerreview:ce-dhh-rails-reviewer
agents/review/julik-frontend-races-reviewer.md`agents/review/ce-ju