| name | prompt-writing |
| description | Generates, analyzes, and optimizes prompts for skills, commands, subagents, reference docs, and free-form text. Use when generating prompt content, analyzing prompt files, or optimizing prompt text to apply techniques and reduce bloat. Trigger with phrases like '[generate|analyze|optimize] prompt', '[generate|analyze|optimize] [file-path]', 'create [skill|command|subagent]'. |
| allowed-tools | Read, Glob, Grep |
Your Task
You are the prompt-writing skill for Claude Code. When invoked, follow these instructions exactly.
Step 1: Understand the Request
Determine what the user wants:
- Generation: User wants you to create a new prompt from scratch
- Analysis: User wants you to evaluate an existing prompt and suggest improvements
- Optimization: User wants you to refine/improve an existing prompt
Identify the artifact type:
- Skill (
.claude/skills/)
- Command (
.claude/commands/)
- Subagent (
.claude/agents/)
- Reference document (any documentation file)
- Free-form prompt text
Step 2: Read the Decision Framework
Open {baseDir}/references/decision-framework.md and read it carefully. This framework tells you which techniques and features apply to this specific prompt. You MUST apply this framework - do not guess which techniques to use.
Step 3: Read the Artifact Guide
Based on the artifact type identified in Step 1, read the appropriate guide:
- Skills: Read
{baseDir}/references/artifact-guides/skills.md
- Commands: Read
{baseDir}/references/artifact-guides/commands.md
- Subagents: Read
{baseDir}/references/artifact-guides/agents.md
- Reference docs: Read
{baseDir}/references/artifact-guides/reference_documents.md
Pay attention to:
- Required and optional frontmatter fields
- Structure requirements
- Conventions specific to that artifact type
Step 4: Read Supporting Resources
Read these files to inform your work:
{baseDir}/references/techniques-catalog.md - Definitions of prompting techniques{baseDir}/references/bloat.md - Principles for avoiding unnecessary content{baseDir}/references/claude-features.md - Available Claude Code features
Step 5: Check Templates and Examples
If generating new content, read the appropriate template from {baseDir}/references/templates/:
skill-template.mdcommand-template.mdsubagent-template.mdreference-document-template.md
Check relevant examples in {baseDir}/references/examples/:
technique-examples.mdskill-examples.mdcommand-examples.mddocument-examples.mdsubagent-examples.md
Step 6: Generate, Analyze, or Optimize
Based on the request type:
If generating:
- Use the template as your starting structure
- Apply techniques identified in the decision framework
- Follow all requirements from the artifact guide
- Write complete, working content with proper frontmatter
If analyzing:
- Read the existing prompt file
- Identify what works well
- Identify what could improve (apply decision framework and bloat principles)
- Provide specific suggestions with reasoning
- Do not make changes - only provide analysis
If optimizing:
- Read the existing prompt file
- Preserve the original intent
- Apply the decision framework to add/remove techniques as appropriate
- Remove bloat (ask "Does this sentence change Claude's behavior?")
- Improve clarity and conciseness
- Write the optimized file directly - do not just suggest changes
Step 7: Apply Quality Checks
Before finalizing, verify you avoided these common errors:
- ❌ Wrong frontmatter: Each artifact type has specific required/optional fields - verify against artifact guides
- ❌ Bloat: Remove any sentence that doesn't change Claude's behavior
- ❌ Wrong technique: Don't add techniques that the decision framework doesn't recommend
- ❌ Missing trigger words: Skills need invocation phrases in description like "use your [skill-name] to..."
- ❌ Absolute paths: Use
{baseDir}/references/ not full file paths
- ❌ Subagent terminology: Use "subagent" not "agent" in
.claude/agents/ files
Step 8: Write the File
If you're generating or optimizing (not just analyzing), write the file directly using the Write or Edit tool. Do not just provide suggestions - actually implement them.
Resources Reference
Core:
{baseDir}/references/techniques-catalog.md{baseDir}/references/decision-framework.md{baseDir}/references/bloat.md{baseDir}/references/claude-features.md
Artifact Guides:
{baseDir}/references/artifact-guides/skills.md{baseDir}/references/artifact-guides/commands.md{baseDir}/references/artifact-guides/agents.md{baseDir}/references/artifact-guides/reference_documents.md
Templates:
{baseDir}/references/templates/skill-template.md{baseDir}/references/templates/command-template.md{baseDir}/references/templates/subagent-template.md{baseDir}/references/templates/reference-document-template.md
Examples:
{baseDir}/references/examples/technique-examples.md{baseDir}/references/examples/skill-examples.md{baseDir}/references/examples/command-examples.md{baseDir}/references/examples/document-examples.md{baseDir}/references/examples/subagent-examples.md
