grey-haven-prompt-engineering
Prompt Engineering Skill
Master 26 documented principles for crafting effective prompts that get high-quality LLM responses on the first try.
Description
This skill provides comprehensive guidance on prompt engineering principles, patterns, and templates for technical tasks, learning content, creative writing, and research. Improves first-response quality by 400%+.
What's Included
Examples (examples/)
- Technical task prompts - 5 transformations (debugging, implementation, architecture, code review, optimization)
- Learning task prompts - 4 transformations (concept explanation, tutorials, comparisons, skill paths)
- Common fixes - 10 quick patterns for immediate improvement
- Before/after comparisons - Real examples with measured improvements
Reference Guides (reference/)
- 26 principles guide - Complete reference with examples, when to use, impact metrics
- Anti-patterns - 12 common mistakes and how to fix them
- Quick reference - Principle categories and selection matrix
Templates (templates/)
- Technical templates - 5 ready-to-use formats (code, debug, architecture, review, performance)
- Learning templates - 4 educational formats (concept explanation, tutorial, comparison, skill path)
- Creative templates - Writing, brainstorming, design prompts
- Research templates - Analysis, comparison, decision frameworks
Checklists (checklists/)
- 23-point quality checklist - Verification before submission with scoring (20+ = excellent)
- Quick improvement guide - Priority fixes for weak prompts
- Category-specific checklists - Technical, learning, creative, research
Key Principles (Highlights)
Content & Clarity:
- Principle 1: No chat, concise
- Principle 2: Specify audience
- Principle 9: Direct, specific task
- Principle 21: Rich context
- Principle 25: Explicit requirements
Structure:
- Principle 3: Break down complex tasks
- Principle 8: Use delimiters (###Headers###)
- Principle 17: Specify output format
Reasoning:
- Principle 12: Request step-by-step
- Principle 19: Chain-of-thought
- Principle 20: Provide examples
Impact Metrics
| Task Type | Weak Prompt Quality | Strong Prompt Quality | Improvement |
|---|---|---|---|
| Technical (code/debug) | 40% success | 98% success | +145% |
| Learning (tutorials) | 50% completion | 90% completion | +80% |
| Creative (writing) | 45% satisfaction | 85% satisfaction | +89% |
| Research (analysis) | 35% actionable | 90% actionable | +157% |
Use This Skill When
- LLM responses are too general or incorrect
- Need to improve prompt quality before submission
- Training team members on effective prompting
- Documenting prompt patterns for reuse
- Optimizing AI-assisted workflows
Related Agents
prompt-engineer- Automated prompt analysis and improvementdocumentation-alignment-verifier- Ensure prompts match documentation- All other agents - Improved agent effectiveness with better prompts
Quick Start
# Check quality of your prompt
cat checklists/prompt-quality-checklist.md
# View examples for your task type
cat examples/technical-task-prompts.md
cat examples/learning-task-prompts.md
# Use templates
cat templates/technical-prompt-template.md
# Learn all principles
cat reference/prompt-principles-guide.md
RED-GREEN-REFACTOR for Prompts
- RED: Test your current prompt → Likely produces weak results
- GREEN: Apply principles from checklist → Improve quality
- REFACTOR: Refine with templates and examples → Achieve excellence
Skill Version: 1.0 Principles Documented: 26 Success Rate: 90%+ first-response quality with strong prompts Last Updated: 2025-01-15
More from greyhaven-ai/claude-code-config
grey-haven-creative-writing
Professional writing assistance for blogs, research articles, fiction, essays, and marketing copy. Use when users want to write, edit, or improve any form of written content. Triggers: 'write a blog', 'write an article', 'help me write', 'write a story', 'write a chapter', 'draft an essay', 'creative writing', 'improve my writing', 'edit my writing', 'write copy', 'content writing'.
139creative-writing
Professional writing assistance for blogs, research articles, fiction, essays, and marketing copy. Use when users want to write, edit, or improve any form of written content. Triggers: 'write a blog', 'write an article', 'help me write', 'write a story', 'write a chapter', 'draft an essay', 'creative writing', 'improve my writing', 'edit my writing', 'write copy', 'content writing'.
33grey-haven-ontological-documentation
Create comprehensive ontological documentation for Grey Haven systems - extract domain concepts from TanStack Start and FastAPI codebases, model semantic relationships, generate visual representations of system architecture, and document business domains. Use when onboarding, documenting architecture, or analyzing legacy systems.
12grey-haven-api-design
Design RESTful APIs following Grey Haven standards - FastAPI routes, Pydantic schemas, HTTP status codes, pagination, filtering, error responses, OpenAPI docs, and multi-tenant patterns. Use when creating API endpoints, designing REST resources, implementing server functions, configuring FastAPI, writing Pydantic schemas, setting up error handling, implementing pagination, or when user mentions 'API', 'endpoint', 'REST', 'FastAPI', 'Pydantic', 'server function', 'OpenAPI', 'pagination', 'validation', 'error handling', 'rate limiting', 'CORS', or 'authentication'.
12grey-haven-llm-project-development
Build LLM-powered applications and pipelines using proven methodology - task-model fit analysis, pipeline architecture, structured outputs, file-based state, and cost estimation. Use when building AI features, data processing pipelines, agents, or any LLM-integrated system. Inspired by Karpathy's methodology and production case studies.
11grey-haven-tdd-python
Python Test-Driven Development expertise with pytest, strict red-green-refactor methodology, FastAPI testing patterns, and Pydantic model testing. Use when implementing Python features with TDD, writing pytest tests, testing FastAPI endpoints, developing with test-first approach, or when user mentions 'Python TDD', 'pytest', 'FastAPI testing', 'red-green-refactor', 'Python unit tests', 'test-driven Python', or 'Python test coverage'.
11