71 lines
3.3 KiB
Markdown
71 lines
3.3 KiB
Markdown
---
|
|
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"
|
|
---
|
|
|
|
## Operating Modes
|
|
|
|
**Generation**: Takes user intent and artifact type → generates complete prompt with appropriate frontmatter, techniques, and Claude Code features.
|
|
|
|
**Analysis**: Evaluates existing prompt → identifies what works, what could improve, suggests specific enhancements with reasoning.
|
|
|
|
**Optimization**: Refines prompt → preserves intent, applies decision framework, improves clarity/conciseness, explains changes.
|
|
|
|
## Workflow
|
|
|
|
1. **Understand context**: Determine artifact type (skill/command/subagent/reference doc/free-form) and user's goal
|
|
2. **Apply decision framework**: Use `{baseDir}/references/decision-framework.md` to determine which techniques and features to add
|
|
3. **Check artifact requirements**:
|
|
- Skills: `{baseDir}/references/artifact-guides/skills.md`
|
|
- Commands: `{baseDir}/references/artifact-guides/commands.md`
|
|
- Subagents: `{baseDir}/references/artifact-guides/agents.md`
|
|
- Reference docs: `{baseDir}/references/artifact-guides/reference_documents.md`
|
|
4. **Apply techniques**: Reference `{baseDir}/references/techniques-catalog.md` for definitions
|
|
5. **Avoid bloat**: Follow `{baseDir}/references/bloat.md` principles
|
|
6. **Use Claude features**: Reference `{baseDir}/references/claude-features.md` when appropriate
|
|
7. **Use templates**: Start from `{baseDir}/references/templates/` for structure
|
|
8. **Reference examples**: Check `{baseDir}/references/examples/` for good/bad patterns
|
|
|
|
## Common Errors
|
|
|
|
**Wrong frontmatter**: Each artifact type has specific required/optional fields - verify against artifact guides
|
|
**Bloat**: Removed by asking "Does this sentence change Claude's behavior?"
|
|
**Wrong technique**: Apply decision framework - not all prompts benefit from CoT or Few-Shot
|
|
**Missing trigger words**: Skills need invocation phrases like "use your [skill-name] to..."
|
|
**Absolute paths**: Use `{baseDir}/references/` not full paths
|
|
**Subagent terminology**: Use "subagent" not "agent" in `.claude/agents/` files
|
|
|
|
## Resources
|
|
|
|
**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`
|