prompt-writing

bcasci's avatarfrom bcasci

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]'.

⭐1stars🔀0forks📁View on GitHub🕐Updated Dec 29, 2025
[Prompt Templates and Packaging]

When & Why to Use This Skill

This Claude skill provides a comprehensive framework for generating, analyzing, and optimizing prompts for skills, commands, and subagents. It streamlines the development of AI-driven tools by applying standardized prompting techniques, removing redundant 'bloat,' and ensuring all artifacts adhere to best practices for performance and clarity within the Claude Code ecosystem.

Use Cases

  • Generating new custom skills or commands from scratch using standardized templates and a structured decision framework.
  • Auditing existing prompt files to identify and remove 'bloat'—instructions that do not change AI behavior but consume context.
  • Optimizing subagent prompts to ensure they use correct terminology and follow architectural guidelines for complex task delegation.
  • Refining reference documentation to make it more efficient for AI consumption, ensuring key information is prioritized and clear.
  • Applying advanced prompting techniques (like Chain of Thought or Few-Shot) systematically based on a predefined techniques catalog.
nameprompt-writing
descriptionGenerates, analyzes, and optimizes prompts for skills, commands,
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.md
  • command-template.md
  • subagent-template.md
  • reference-document-template.md

Check relevant examples in {baseDir}/references/examples/:

  • technique-examples.md
  • skill-examples.md
  • command-examples.md
  • document-examples.md
  • subagent-examples.md

Step 6: Generate, Analyze, or Optimize

Based on the request type:

If generating:

  1. Use the template as your starting structure
  2. Apply techniques identified in the decision framework
  3. Follow all requirements from the artifact guide
  4. Write complete, working content with proper frontmatter

If analyzing:

  1. Read the existing prompt file
  2. Identify what works well
  3. Identify what could improve (apply decision framework and bloat principles)
  4. Provide specific suggestions with reasoning
  5. Do not make changes - only provide analysis

If optimizing:

  1. Read the existing prompt file
  2. Preserve the original intent
  3. Apply the decision framework to add/remove techniques as appropriate
  4. Remove bloat (ask "Does this sentence change Claude's behavior?")
  5. Improve clarity and conciseness
  6. 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