cc-os/plugins/cc-architect/references/layout/descriptions.md

Writing Descriptions

Short guidance for description fields on skills, agents, commands, and plugins.

Formula

[Action verb] [what]. [Unambiguous trigger].

• Action verb (Build, Generate, Create, Run)
• What it does (2-5 words)
• Trigger that prevents an "escape hatch" — a reader should not be able to rationalize skipping the tool while still doing the task it covers.

Examples:

• skill: Build Claude Code skills. Use when creating a skill.
• agent: Review code against implementation plan. Use after completing a major project step.
• command: Stage and commit changes. Use when ready to commit.

Full process

For the complete drafting process (reading the formula reference, the escape-hatch test, and how to return the result), run: → ${CLAUDE_PLUGIN_ROOT}/workflows/generate-description.md