grey-haven-prompt-engineering

name	grey-haven-prompt-engineering
description	Master 26 documented prompt engineering principles for crafting effective LLM prompts with 400%+ quality improvement. Includes templates, anti-patterns, and quality checklists for technical, learning, creative, and research tasks. Use when writing prompts for LLMs, improving AI response quality, training on prompting, designing agent instructions, or when user mentions 'prompt engineering', 'better prompts', 'LLM quality', 'prompt templates', 'AI prompts', 'prompt principles', or 'prompt optimization'.
skills	["grey-haven-code-style"]
allowed-tools	["Read","Write","Grep","Glob","TodoWrite"]

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 improvement
• documentation-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

1. RED: Test your current prompt → Likely produces weak results
2. GREEN: Apply principles from checklist → Improve quality
3. 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