prompt-engineer · curiositech — Claude Code skill: LLM prompt design and optimization
prompt-engineer — a skill for crafting and debugging prompts. Eliminates hallucinations, improves response consistency, and strengthens agent instructions through systematic optimization techniques.
MIT 217 installs ★ 274 updated 2026-09-06
npx skills add curiositech/some_claude_skills --skill prompt-engineer -a claude-codeWhat prompt-engineer does
Audits existing prompts to surface ambiguity and contradictions, then applies proven methods: chain-of-thought reasoning, few-shot examples, constraint engineering, role prompting. Each technique addresses a specific failure mode—few-shot examples lift format reliability by 30–50%, while constraint engineering handles edge cases at 50%+ improvement rate.
Works with file reading, prompt editing, and sequential reasoning via mcp__SequentialThinking__sequentialthinking. Introduces the CLEAR framework: context, limits, examples, action, review. Flags anti-patterns—instruction bloat, missing examples, over-constraining that creates contradictions.
Fits chatbot system prompts, agent instructions, and reusable templates that must behave consistently. Separate from end-to-end LLM application development (use ai-engineer) and automated iterative optimization (use automatic-stateful-prompt-improver).
What it helps with
- stop the model from fabricating information or hallucinating details
- make answers to the same question produce consistent output quality
- enforce strict formatting without parsing errors
- clarify and structure instructions for agents or multi-step workflows
- diagnose gaps and contradictions in existing prompts
Example prompts for the agent
- Our refund policy chatbot gives conflicting answers. Analyze the current prompt and suggest improvements.
- Write a system prompt for an invoice parser. Use the CLEAR framework and add examples.
- Output doesn't match the required JSON schema. Rework the instructions with few-shot examples and tighter constraints.
How to install prompt-engineer
1Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill prompt-engineer -a claude-code2Manually: put the files in place
~/.claude/skills/prompt-engineer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/prompt-engineer/
1Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill prompt-engineer -a codex2Manually: put the files in place
.agents/skills/prompt-engineer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill prompt-engineer -a cursor2Manually: put the files in place
.cursor/skills/prompt-engineer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install curiositech/some_claude_skills .claude/skills/prompt-engineer2Manually: put the files in place
.github/skills/prompt-engineer/SKILL.md1Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill prompt-engineer -a gemini-cli2Platform CLI
gemini skills install https://github.com/curiositech/some_claude_skills --path .claude/skills/prompt-engineerManually: put the files in place
.devin/skills/prompt-engineer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill prompt-engineer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about prompt-engineer
How do I install prompt-engineer in Claude Code?
Run npx skills add curiositech/some_claude_skills --skill prompt-engineer -a claude-code, then verify by opening ~/.claude/skills/prompt-engineer/SKILL.md.
What does prompt-engineer do?
Designs, optimizes, and debugs prompts for large language models. Audits existing instructions, applies techniques like chain-of-thought and few-shot examples, tests against adversarial inputs, and quantifies improvements.
When should I use prompt-engineer instead of ai-engineer?
Use prompt-engineer to refine and test prompts, system instructions, and reusable templates. Use ai-engineer for building complete LLM applications in production. Often they work together: prompt-engineer develops solid instructions, then ai-engineer integrates them into a live system.
Source text
SKILL.md · MIT
---
name: prompt-engineer
description: Expert prompt optimization for LLMs and AI systems. Use PROACTIVELY when building AI features, improving agent performance, or crafting system prompts. Masters prompt patterns and techniques.
allowed-tools: Read,Write,Edit,Glob,Grep,mcp__SequentialThinking__sequentialthinking
metadata:
category: AI & Machine Learning
pairs-with:
- skill: ai-engineer
reason: Apply optimized prompts in production LLM applications
- skill: automatic-stateful-prompt-improver
reason: Automated prompt optimization with learning
tags:
- prompts
- llm
- optimization
- ai
- system-design
---
# Prompt Engineer
Expert in crafting, optimizing, and debugging prompts for large language models. Transform vague requirements into precise, effective prompts that produce consistent, high-quality outputs.
## Quick Start
```
User: "My chatbot gives inconsistent answers about our refund policy"
Prompt Engineer:
1. Analyze current prompt structure
2. Identify ambiguity and edge cases
3. Apply constraint engineering
4. Add few-shot examples
5. Test with adversarial inputs
6. Measure improvement
```
**Result**: 40-60% improvement in response consistency
## Core Competencies
### 1. Prompt Architecture
- System prompt design for persona and constraints
- User prompt structure for clarity
- Context window optimization
- Multi-turn conversation design
### 2. Optimization Techniques
| Technique | When to Use | Expected Improvement |
|-----------|-------------|---------------------|
| **Chain-of-Thought** | Complex reasoning | 20-40% accuracy |
| **Few-Shot Examples** | Format consistency | 30-50% reliability |
| **Constraint Engineering** | Edge case handling | 50%+ consistency |
| **Role Prompting** | Domain expertise | 15-25% quality |
| **Self-Consistency** | Critical decisions | 10-20% accuracy |
### 3. Debugging & Testing
- Prompt ablation studies
- Adversarial input testing
- A/B testing frameworks
- Regression detection
## Prompt Patterns
### The CLEAR Framework
```
C - Context: What background does the model need?
L - Limits: What constraints apply?
E - Examples: What does good output look like?
A - Action: What specific task to perform?
R - Review: How to verify correctness?
```
### System Prompt Template
```markdown
You are [ROLE] with expertise in [DOMAIN].
## Your Task
[CLEAR, SPECIFIC INSTRUCTION]
## Constraints
- [CONSTRAINT 1]
- [CONSTRAINT 2]
## Output Format
[EXACT FORMAT SPECIFICATION]
## Examples
Input: [EXAMPLE INPUT]
Output: [EXAMPLE OUTPUT]
```
### Chain-of-Thought Pattern
```markdown
Think through this step-by-step:
1. First, identify [ASPECT 1]
2. Then, analyze [ASPECT 2]
3. Consider [EDGE CASES]
4. Finally, synthesize into [OUTPUT]
Show your reasoning before the final answer.
```
## Optimization Workflow
| Phase | Activities | Tools |
|-------|------------|-------|
| **Analyze** | Review current prompts, identify issues | Read, pattern analysis |
| **Hypothesize** | Form improvement hypotheses | Sequential thinking |
| **Implement** | Apply prompt engineering techniques | Write, Edit |
| **Test** | Validate with diverse inputs | Manual testing |
| **Measure** | Quantify improvement | A/B comparison |
| **Iterate** | Refine based on results | Repeat cycle |
## Common Issues & Fixes
### Issue: Hallucinations
```
Problem: Model fabricates information
Fix: Add "Only use information provided. Say 'I don't know' if uncertain."
```
### Issue: Verbose Output
```
Problem: Model produces too much text
Fix: Add "Be concise. Maximum 3 sentences." + format constraints
```
### Issue: Format Violations
```
Problem: Output doesn't match required format
Fix: Add explicit examples + "Follow this exact format:"
```
### Issue: Context Confusion
```
Problem: Model loses track in long conversations
Fix: Add periodic context summaries + clear role reminders
```
## Anti-Patterns
### Anti-Pattern: Prompt Stuffing
**What it looks like**: Cramming every possible instruction into one prompt
**Why wrong**: Dilutes important instructions, confuses model
**Instead**: Prioritize 3-5 key constraints, use progressive disclosure
### Anti-Pattern: Vague Instructions
**What it looks like**: "Write something good about our product"
**Why wrong**: No measurable criteria, inconsistent outputs
**Instead**: Specific requirements with examples
### Anti-Pattern: Over-Constraining
**What it looks like**: 50+ rules the model must follow
**Why wrong**: Model can't prioritize, contradictions emerge
**Instead**: Essential constraints only, test for necessity
### Anti-Pattern: No Examples
**What it looks like**: Complex format with no concrete examples
**Why wrong**: Model interprets instructions differently
**Instead**: Always include 2-3 representative examples
## Quality Metrics
| Metric | How to Measure | Target |
|--------|----------------|--------|
| **Consistency** | Same input, same output quality | >90% |
| **Accuracy** | Correct information | >95% |
| **Format Compliance** | Follows specified format | >98% |
| **Latency** | Time to first token | <2s |
| **Token Efficiency** | Output tokens per task | -20% waste |
## When to Use
**Use for:**
- Designing system prompts for chatbots
- Optimizing agent instructions
- Reducing hallucinations
- Improving output consistency
- Creating prompt templates
**Do NOT use for:**
- Building LLM applications (use ai-engineer)
- Automated optimization (use automatic-stateful-prompt-improver)
- General coding tasks (use language-specific skills)
- Infrastructure setup (use deployment skills)
---
**Core insight**: Great prompts are like great specifications—specific enough to eliminate ambiguity, flexible enough to handle variation, and tested against adversarial inputs.
**Use with**: ai-engineer (production apps) | automatic-stateful-prompt-improver (automation) | agent-creator (new agents)
© curiositech · MIT · curiositech/some_claude_skills
Similar skills
All skills for AI and ML →prompt-engineer by other authors comes first.