--- name: prompt-engineering-expert description: This skill equips Claude with deep expertise in prompt engineering, custom instructions design, and prompt optimization. It provides comprehensive guidance on crafting effective AI prompts, designing agent instructions, and iteratively improving prompt performance. --- ## Core Expertise Areas ### 1. Prompt Writing Best Practices - **Clarity and Directness**: Writing clear, unambiguous prompts that leave no room for misinterpretation - **Structure and Formatting**: Organizing prompts with proper hierarchy, sections, and visual clarity - **Specificity**: Providing precise instructions with concrete examples and expected outputs - **Context Management**: Balancing necessary context without overwhelming the model - **Tone and Style**: Matching prompt tone to the task requirements ### 2. Advanced Prompt Engineering Techniques - **Chain-of-Thought (CoT) Prompting**: Encouraging step-by-step reasoning for complex tasks - **Few-Shot Prompting**: Using examples to guide model behavior (1-shot, 2-shot, multi-shot) - **XML Tags**: Leveraging structured XML formatting for clarity and parsing - **Role-Based Prompting**: Assigning specific personas or expertise to Claude - **Prefilling**: Starting Claude's response to guide output format - **Prompt Chaining**: Breaking complex tasks into sequential prompts ### 3. Custom Instructions & System Prompts - **System Prompt Design**: Creating effective system prompts for specialized domains - **Custom Instructions**: Designing instructions for AI agents and skills - **Behavioral Guidelines**: Setting appropriate constraints and guidelines - **Personality and Voice**: Defining consistent tone and communication style - **Scope Definition**: Clearly defining what the agent should and shouldn't do ### 4. Prompt Optimization & Refinement - **Performance Analysis**: Evaluating prompt effectiveness and identifying issues - **Iterative Improvement**: Systematically refining prompts based on results - **A/B Testing**: Comparing different prompt variations - **Consistency Enhancement**: Improving reliability and reducing variability - **Token Optimization**: Reducing unnecessary tokens while maintaining quality ### 5. Anti-Patterns & Common Mistakes - **Vagueness**: Identifying and fixing unclear instructions - **Contradictions**: Detecting conflicting requirements - **Over-Specification**: Recognizing when prompts are too restrictive - **Hallucination Risks**: Identifying prompts prone to false information - **Context Leakage**: Preventing unintended information exposure - **Jailbreak Vulnerabilities**: Recognizing and mitigating prompt injection risks ### 6. Evaluation & Testing - **Success Criteria Definition**: Establishing clear metrics for prompt success - **Test Case Development**: Creating comprehensive test cases - **Failure Analysis**: Understanding why prompts fail - **Regression Testing**: Ensuring improvements don't break existing functionality - **Edge Case Handling**: Testing boundary conditions and unusual inputs ### 7. Multimodal & Advanced Prompting - **Vision Prompting**: Crafting prompts for image analysis and understanding - **File-Based Prompting**: Working with documents, PDFs, and structured data - **Embeddings Integration**: Using embeddings for semantic search and retrieval - **Tool Use Prompting**: Designing prompts that effectively use tools and APIs - **Extended Thinking**: Leveraging extended thinking for complex reasoning ## Key Capabilities - **Prompt Analysis**: Reviewing existing prompts and identifying improvement opportunities - **Prompt Generation**: Creating new prompts from scratch for specific use cases - **Prompt Refinement**: Iteratively improving prompts based on performance - **Custom Instruction Design**: Creating specialized instructions for agents and skills - **Best Practice Guidance**: Providing expert advice on prompt engineering principles - **Anti-Pattern Recognition**: Identifying and correcting common mistakes - **Testing Strategy**: Developing evaluation frameworks for prompt validation - **Documentation**: Creating clear documentation for prompt usage and maintenance ## Use Cases - Refining vague or ineffective prompts - Creating specialized system prompts for specific domains - Designing custom instructions for AI agents and skills - Optimizing prompts for consistency and reliability - Teaching prompt engineering best practices - Debugging prompt performance issues - Creating prompt templates for reusable workflows - Improving prompt efficiency and token usage - Developing evaluation frameworks for prompt testing ## Skill Limitations - Does not execute code or run actual prompts (analysis only) - Cannot access real-time data or external APIs - Provides guidance based on best practices, not guaranteed results - Recommendations should be tested with actual use cases - Does not replace human judgment in critical applications ## Integration Notes This skill works well with: - Claude Code for testing and iterating on prompts - Agent SDK for implementing custom instructions - Files API for analyzing prompt documentation - Vision capabilities for multimodal prompt design - Extended thinking for complex prompt reasoning FILE:START_HERE.md # 🎯 Prompt Engineering Expert Skill - Complete Package ## ✅ What Has Been Created A **comprehensive Claude Skill** for prompt engineering expertise with: ### 📦 Complete Package Contents - **7 Core Documentation Files** - **3 Specialized Guides** (Best Practices, Techniques, Troubleshooting) - **10 Real-World Examples** with before/after comparisons - **Multiple Navigation Guides** for easy access - **Checklists and Templates** for practical use ### 📍 Location ``` ~/Documents/prompt-engineering-expert/ ``` --- ## 📋 File Inventory ### Core Skill Files (4 files) | File | Purpose | Size | |------|---------|------| | **SKILL.md** | Skill metadata & overview | ~1 KB | | **CLAUDE.md** | Main skill instructions | ~3 KB | | **README.md** | User guide & getting started | ~4 KB | | **GETTING_STARTED.md** | How to upload & use | ~3 KB | ### Documentation (3 files) | File | Purpose | Coverage | |------|---------|----------| | **docs/BEST_PRACTICES.md** | Comprehensive best practices | Core principles, advanced techniques, evaluation, anti-patterns | | **docs/TECHNIQUES.md** | Advanced techniques guide | 8 major techniques with examples | | **docs/TROUBLESHOOTING.md** | Problem solving | 8 common issues + debugging workflow | ### Examples & Navigation (3 files) | File | Purpose | Content | |------|---------|---------| | **examples/EXAMPLES.md** | Real-world examples | 10 practical examples with templates | | **INDEX.md** | Complete navigation | Quick links, learning paths, integration points | | **SUMMARY.md** | What was created | Overview of all components | --- ## 🎓 Expertise Covered ### 7 Core Expertise Areas 1. ✅ **Prompt Writing Best Practices** - Clarity, structure, specificity 2. ✅ **Advanced Techniques** - CoT, few-shot, XML, role-based, prefilling, chaining 3. ✅ **Custom Instructions** - System prompts, behavioral guidelines, scope 4. ✅ **Optimization** - Performance analysis, iterative improvement, token efficiency 5. ✅ **Anti-Patterns** - Vagueness, contradictions, hallucinations, jailbreaks 6. ✅ **Evaluation** - Success criteria, test cases, failure analysis 7. ✅ **Multimodal** - Vision, files, embeddings, extended thinking ### 8 Key Capabilities 1. ✅ Prompt Analysis 2. ✅ Prompt Generation 3. ✅ Prompt Refinement 4. ✅ Custom Instruction Design 5. ✅ Best Practice Guidance 6. ✅ Anti-Pattern Recognition 7. ✅ Testing Strategy 8. ✅ Documentation --- ## 🚀 How to Use ### Step 1: Upload the Skill ``` Go to Claude.com → Click "+" → Upload Skill → Select folder ``` ### Step 2: Ask Claude ``` "Review this prompt and suggest improvements: [YOUR PROMPT]" ``` ### Step 3: Get Expert Guidance Claude will analyze using the skill's expertise and provide recommendations. --- ## 📚 Documentation Breakdown ### BEST_PRACTICES.md (~8 KB) - Core principles (clarity, conciseness, degrees of freedom) - Advanced techniques (8 techniques with explanations) - Custom instructions design - Skill structure best practices - Evaluation & testing frameworks - Anti-patterns to avoid - Workflows and feedback loops - Content guidelines - Multimodal prompting - Development workflow - Complete checklist ### TECHNIQUES.md (~10 KB) - Chain-of-Thought prompting (with examples) - Few-Shot learning (1-shot, 2-shot, multi-shot) - Structured output with XML tags - Role-based prompting - Prefilling responses - Prompt chaining - Context management - Multimodal prompting - Combining techniques - Anti-patterns ### TROUBLESHOOTING.md (~6 KB) - 8 common issues with solutions - Debugging workflow - Quick reference table - Testing checklist ### EXAMPLES.md (~8 KB) - 10 real-world examples - Before/after comparisons - Templates and frameworks - Optimization checklists --- ## 💡 Key Features ### ✨ Comprehensive - Covers all major aspects of prompt engineering - From basics to advanced techniques - Real-world examples and templates ### 🎯 Practical - Actionable guidance - Step-by-step instructions - Ready-to-use templates ### 📖 Well-Organized - Clear structure with progressive disclosure - Multiple navigation guides - Quick reference tables ### 🔍 Detailed - 8 common issues with solutions - 10 real-world examples - Multiple checklists ### 🚀 Ready to Use - Can be uploaded immediately - No additional setup needed - Works with Claude.com and API --- ## 📊 Statistics | Metric | Value | |--------|-------| | Total Files | 10 | | Total Documentation | ~40 KB | | Core Expertise Areas | 7 | | Key Capabilities | 8 | | Use Cases | 9 | | Common Issues Covered | 8 | | Real-World Examples | 10 | | Advanced Techniques | 8 | | Best Practices | 50+ | | Anti-Patterns | 10+ | --- ## 🎯 Use Cases ### 1. Refining Vague Prompts Transform unclear prompts into specific, actionable ones. ### 2. Creating Specialized Prompts Design prompts for specific domains or tasks. ### 3. Designing Agent Instructions Create custom instructions for AI agents and skills. ### 4. Optimizing for Consistency Improve reliability and reduce variability. ### 5. Teaching Best Practices Learn prompt engineering principles and techniques. ### 6. Debugging Prompt Issues Identify and fix problems with existing prompts. ### 7. Building Evaluation Frameworks Develop test cases and success criteria. ### 8. Multimodal Prompting Design prompts for vision, embeddings, and files. ### 9. Creating Prompt Templates Build reusable prompt templates for workflows. --- ## ✅ Quality Checklist - ✅ Based on official Anthropic documentation - ✅ Comprehensive coverage of prompt engineering - ✅ Real-world examples and templates - ✅ Clear, well-organized structure - ✅ Progressive disclosure for learning - ✅ Multiple navigation guides - ✅ Practical, actionable guidance - ✅ Troubleshooting and debugging help - ✅ Best practices and anti-patterns - ✅ Ready to upload and use --- ## 🔗 Integration Points Works seamlessly with: - **Claude.com** - Upload and use directly - **Claude Code** - For testing prompts - **Agent SDK** - For programmatic use - **Files API** - For analyzing documentation - **Vision** - For multimodal design - **Extended Thinking** - For complex reasoning --- ## 📖 Learning Paths ### Beginner (1-2 hours) 1. Read: README.md 2. Read: BEST_PRACTICES.md (Core Principles) 3. Review: EXAMPLES.md (Examples 1-3) 4. Try: Create a simple prompt ### Intermediate (2-4 hours) 1. Read: TECHNIQUES.md (Sections 1-4) 2. Review: EXAMPLES.md (Examples 4-7) 3. Read: TROUBLESHOOTING.md 4. Try: Refine an existing prompt ### Advanced (4+ hours) 1. Read: TECHNIQUES.md (All sections) 2. Review: EXAMPLES.md (All examples) 3. Read: BEST_PRACTICES.md (All sections) 4. Try: Combine multiple techniques --- ## 🎁 What You Get ### Immediate Benefits - Expert prompt engineering guidance - Real-world examples and templates - Troubleshooting help - Best practices reference - Anti-pattern recognition ### Long-Term Benefits - Improved prompt quality - Faster iteration cycles - Better consistency - Reduced token usage - More effective AI interactions --- ## 🚀 Next Steps 1. **Navigate to the folder** ``` ~/Documents/prompt-engineering-expert/ ``` 2. **Upload the skill** to Claude.com - Click "+" → Upload Skill → Select folder 3. **Start using it** - Ask Claude to review your prompts - Request custom instructions - Get troubleshooting help 4. **Explore the documentation** - Start with README.md - Review examples - Learn advanced techniques 5. **Share with your team** - Collaborate on prompt engineering - Build better prompts together - Improve AI interactions --- ## 📞 Support Resources ### Within the Skill - Comprehensive documentation - Real-world examples - Troubleshooting guides - Best practice checklists - Quick reference tables ### External Resources - Claude Docs: https://docs.claude.com - Anthropic Blog: https://www.anthropic.com/blog - Claude Cookbooks: https://github.com/anthropics/claude-cookbooks --- ## 🎉 You're All Set! Your **Prompt Engineering Expert Skill** is complete and ready to use! ### Quick Start 1. Open `~/Documents/prompt-engineering-expert/` 2. Read `GETTING_STARTED.md` for upload instructions 3. Upload to Claude.com 4. Start improving your prompts! FILE:README.md # README - Prompt Engineering Expert Skill ## Overview The **Prompt Engineering Expert** skill equips Claude with deep expertise in prompt engineering, custom instructions design, and prompt optimization. This comprehensive skill provides guidance on crafting effective AI prompts, designing agent instructions, and iteratively improving prompt performance. ## What This Skill Provides ### Core Expertise - **Prompt Writing Best Practices**: Clear, direct prompts with proper structure - **Advanced Techniques**: Chain-of-thought, few-shot prompting, XML tags, role-based prompting - **Custom Instructions**: System prompts and agent instructions design - **Optimization**: Analyzing and refining existing prompts - **Evaluation**: Testing frameworks and success criteria - **Anti-Patterns**: Identifying and correcting common mistakes - **Multimodal**: Vision, embeddings, and file-based prompting ### Key Capabilities 1. **Prompt Analysis** - Review existing prompts - Identify improvement opportunities - Spot anti-patterns and issues - Suggest specific refinements 2. **Prompt Generation** - Create new prompts from scratch - Design for specific use cases - Ensure clarity and effectiveness - Optimize for consistency 3. **Custom Instructions** - Design system prompts - Create agent instructions - Define behavioral guidelines - Set appropriate constraints 4. **Best Practice Guidance** - Explain prompt engineering principles - Teach advanced techniques - Share real-world examples - Provide implementation guidance 5. **Testing & Validation** - Develop test cases - Define success criteria - Evaluate prompt performance - Identify edge cases ## How to Use This Skill ### For Prompt Analysis ``` "Review this prompt and suggest improvements: [YOUR PROMPT] Focus on: clarity, specificity, format, and consistency." ``` ### For Prompt Generation ``` "Create a prompt that: - [Requirement 1] - [Requirement 2] - [Requirement 3] The prompt should handle [use cases]." ``` ### For Custom Instructions ``` "Design custom instructions for an agent that: - [Role/expertise] - [Key responsibilities] - [Behavioral guidelines]" ``` ### For Troubleshooting ``` "This prompt isn't working well: [PROMPT] Issues: [DESCRIBE ISSUES] How can I fix it?" ``` ## Skill Structure ``` prompt-engineering-expert/ ├── SKILL.md # Skill metadata ├── CLAUDE.md # Main instructions ├── README.md # This file ├── docs/ │ ├── BEST_PRACTICES.md # Best practices guide │ ├── TECHNIQUES.md # Advanced techniques │ └── TROUBLESHOOTING.md # Common issues & fixes └── examples/ └── EXAMPLES.md # Real-world examples ``` ## Key Concepts ### Clarity - Explicit objectives - Precise language - Concrete examples - Logical structure ### Conciseness - Focused content - No redundancy - Progressive disclosure - Token efficiency ### Consistency - Defined constraints - Specified format - Clear guidelines - Repeatable results ### Completeness - Sufficient context - Edge case handling - Success criteria - Error handling ## Common Use Cases ### 1. Refining Vague Prompts Transform unclear prompts into specific, actionable ones. ### 2. Creating Specialized Prompts Design prompts for specific domains or tasks. ### 3. Designing Agent Instructions Create custom instructions for AI agents and skills. ### 4. Optimizing for Consistency Improve reliability and reduce variability. ### 5. Debugging Prompt Issues Identify and fix problems with existing prompts. ### 6. Teaching Best Practices Learn prompt engineering principles and techniques. ### 7. Building Evaluation Frameworks Develop test cases and success criteria. ### 8. Multimodal Prompting Design prompts for vision, embeddings, and files. ## Best Practices Summary ### Do's ✅ - Be clear and specific - Provide examples - Specify format - Define constraints - Test thoroughly - Document assumptions - Use progressive disclosure - Handle edge cases ### Don'ts ❌ - Be vague or ambiguous - Assume understanding - Skip format specification - Ignore edge cases - Over-specify constraints - Use jargon without explanation - Hardcode values - Ignore error handling ## Advanced Topics ### Chain-of-Thought Prompting Encourage step-by-step reasoning for complex tasks. ### Few-Shot Learning Use examples to guide behavior without explicit instructions. ### Structured Output Use XML tags for clarity and parsing. ### Role-Based Prompting Assign expertise to guide behavior. ### Prompt Chaining Break complex tasks into sequential prompts. ### Context Management Optimize token usage and clarity. ### Multimodal Integration Work with images, files, and embeddings. ## Limitations - **Analysis Only**: Doesn't execute code or run actual prompts - **No Real-Time Data**: Can't access external APIs or current data - **Best Practices Based**: Recommendations based on established patterns - **Testing Required**: Suggestions should be validated with actual use cases - **Human Judgment**: Doesn't replace human expertise in critical applications ## Integration with Other Skills This skill works well with: - **Claude Code**: For testing and iterating on prompts - **Agent SDK**: For implementing custom instructions - **Files API**: For analyzing prompt documentation - **Vision**: For multimodal prompt design - **Extended Thinking**: For complex prompt reasoning ## Getting Started ### Quick Start 1. Share your prompt or describe your need 2. Receive analysis and recommendations 3. Implement suggested improvements 4. Test and validate 5. Iterate as needed ### For Beginners - Start with "BEST_PRACTICES.md" - Review "EXAMPLES.md" for real-world cases - Try simple prompts first - Gradually increase complexity ### For Advanced Users - Explore "TECHNIQUES.md" for advanced methods - Review "TROUBLESHOOTING.md" for edge cases - Combine multiple techniques - Build custom frameworks ## Documentation ### Main Documents - **BEST_PRACTICES.md**: Comprehensive best practices guide - **TECHNIQUES.md**: Advanced prompt engineering techniques - **TROUBLESHOOTING.md**: Common issues and solutions - **EXAMPLES.md**: Real-world examples and templates ### Quick References - Naming conventions - File structure - YAML frontmatter - Token budgets - Checklists ## Support & Resources ### Within This Skill - Detailed documentation - Real-world examples - Troubleshooting guides - Best practice checklists - Quick reference tables ### External Resources - Claude Documentation: https://docs.claude.com - Anthropic Blog: https://www.anthropic.com/blog - Claude Cookbooks: https://github.com/anthropics/claude-cookbooks - Prompt Engineering Guide: https://www.promptingguide.ai ## Version History ### v1.0 (Current) - Initial release - Core expertise areas - Best practices documentation - Advanced techniques guide - Troubleshooting guide - Real-world examples ## Contributing This skill is designed to evolve. Feedback and suggestions for improvement are welcome. ## License This skill is provided as part of the Claude ecosystem. --- ## Quick Links - [Best Practices Guide](docs/BEST_PRACTICES.md) - [Advanced Techniques](docs/TECHNIQUES.md) - [Troubleshooting Guide](docs/TROUBLESHOOTING.md) - [Examples & Templates](examples/EXAMPLES.md) --- **Ready to improve your prompts?** Start by sharing your current prompt or describing what you need help with! FILE:SUMMARY.md # Prompt Engineering Expert Skill - Summary ## What Was Created A comprehensive Claude Skill for **prompt engineering expertise** with deep knowledge of: - Prompt writing best practices - Custom instructions design - Prompt optimization and refinement - Advanced techniques (CoT, few-shot, XML tags, etc.) - Evaluation frameworks and testing - Anti-pattern recognition - Multimodal prompting ## Skill Structure ``` ~/Documents/prompt-engineering-expert/ ├── SKILL.md # Skill metadata & overview ├── CLAUDE.md # Main skill instructions ├── README.md # User guide & getting started ├── docs/ │ ├── BEST_PRACTICES.md # Comprehensive best practices (from official docs) │ ├── TECHNIQUES.md # Advanced techniques guide │ └── TROUBLESHOOTING.md # Common issues & solutions └── examples/ └── EXAMPLES.md # 10 real-world examples & templates ``` ## Key Files ### 1. **SKILL.md** (Overview) - High-level description - Key capabilities - Use cases - Limitations ### 2. **CLAUDE.md** (Main Instructions) - Core expertise areas (7 major areas) - Key capabilities (8 capabilities) - Use cases (9 use cases) - Skill limitations - Integration notes ### 3. **README.md** (User Guide) - Overview and what's provided - How to use the skill - Skill structure - Key concepts - Common use cases - Best practices summary - Getting started guide ### 4. **docs/BEST_PRACTICES.md** (Best Practices) - Core principles (clarity, conciseness, degrees of freedom) - Advanced techniques (CoT, few-shot, XML, role-based, prefilling, chaining) - Custom instructions design - Skill structure best practices - Evaluation & testing - Anti-patterns to avoid - Workflows and feedback loops - Content guidelines - Multimodal prompting - Development workflow - Comprehensive checklist ### 5. **docs/TECHNIQUES.md** (Advanced Techniques) - Chain-of-Thought prompting (with examples) - Few-Shot learning (1-shot, 2-shot, multi-shot) - Structured output with XML tags - Role-based prompting - Prefilling responses - Prompt chaining - Context management - Multimodal prompting - Combining techniques - Anti-patterns ### 6. **docs/TROUBLESHOOTING.md** (Troubleshooting) - 8 common issues with solutions: 1. Inconsistent outputs 2. Hallucinations 3. Vague responses 4. Wrong length 5. Wrong format 6. Refuses to respond 7. Prompt too long 8. Doesn't generalize - Debugging workflow - Quick reference table - Testing checklist ### 7. **examples/EXAMPLES.md** (Real-World Examples) - 10 practical examples: 1. Refining vague prompts 2. Custom instructions for agents 3. Few-shot classification 4. Chain-of-thought analysis 5. XML-structured prompts 6. Iterative refinement 7. Anti-pattern recognition 8. Testing framework 9. Skill metadata template 10. Optimization checklist ## Core Expertise Areas 1. **Prompt Writing Best Practices** - Clarity and directness - Structure and formatting - Specificity - Context management - Tone and style 2. **Advanced Prompt Engineering Techniques** - Chain-of-Thought (CoT) prompting - Few-Shot prompting - XML tags - Role-based prompting - Prefilling - Prompt chaining 3. **Custom Instructions & System Prompts** - System prompt design - Custom instructions - Behavioral guidelines - Personality and voice - Scope definition 4. **Prompt Optimization & Refinement** - Performance analysis - Iterative improvement - A/B testing - Consistency enhancement - Token optimization 5. **Anti-Patterns & Common Mistakes** - Vagueness - Contradictions - Over-specification - Hallucination risks - Context leakage - Jailbreak vulnerabilities 6. **Evaluation & Testing** - Success criteria definition - Test case development - Failure analysis - Regression testing - Edge case handling 7. **Multimodal & Advanced Prompting** - Vision prompting - File-based prompting - Embeddings integration - Tool use prompting - Extended thinking ## Key Capabilities 1. **Prompt Analysis** - Review and improve existing prompts 2. **Prompt Generation** - Create new prompts from scratch 3. **Prompt Refinement** - Iteratively improve prompts 4. **Custom Instruction Design** - Create specialized instructions 5. **Best Practice Guidance** - Teach prompt engineering principles 6. **Anti-Pattern Recognition** - Identify and correct mistakes 7. **Testing Strategy** - Develop evaluation frameworks 8. **Documentation** - Create clear usage documentation ## How to Use This Skill ### For Prompt Analysis ``` "Review this prompt and suggest improvements: [YOUR PROMPT]" ``` ### For Prompt Generation ``` "Create a prompt that: - [Requirement 1] - [Requirement 2] - [Requirement 3]" ``` ### For Custom Instructions ``` "Design custom instructions for an agent that: - [Role/expertise] - [Key responsibilities]" ``` ### For Troubleshooting ``` "This prompt isn't working: [PROMPT] Issues: [DESCRIBE ISSUES] How can I fix it?" ``` ## Best Practices Included ### Do's ✅ - Be clear and specific - Provide examples - Specify format - Define constraints - Test thoroughly - Document assumptions - Use progressive disclosure - Handle edge cases ### Don'ts ❌ - Be vague or ambiguous - Assume understanding - Skip format specification - Ignore edge cases - Over-specify constraints - Use jargon without explanation - Hardcode values - Ignore error handling ## Documentation Quality - **Comprehensive**: Covers all major aspects of prompt engineering - **Practical**: Includes real-world examples and templates - **Well-Organized**: Clear structure with progressive disclosure - **Actionable**: Specific guidance with step-by-step instructions - **Tested**: Based on official Anthropic documentation - **Reusable**: Templates and checklists for common tasks ## Integration Points Works well with: - Claude Code (for testing prompts) - Agent SDK (for implementing instructions) - Files API (for analyzing documentation) - Vision capabilities (for multimodal design) - Extended thinking (for complex reasoning) ## Next Steps 1. **Upload the skill** to Claude using the Skills API or Claude Code 2. **Test with sample prompts** to verify functionality 3. **Iterate based on feedback** to refine and improve 4. **Share with team** for collaborative prompt engineering 5. **Extend as needed** with domain-specific examples FILE:INDEX.md # Prompt Engineering Expert Skill - Complete Index ## 📋 Quick Navigation ### Getting Started - **[README.md](README.md)** - Start here! Overview, how to use, and quick start guide - **[SUMMARY.md](SUMMARY.md)** - What was created and how to use it ### Core Skill Files - **[SKILL.md](SKILL.md)** - Skill metadata and capabilities overview - **[CLAUDE.md](CLAUDE.md)** - Main skill instructions and expertise areas ### Documentation - **[docs/BEST_PRACTICES.md](docs/BEST_PRACTICES.md)** - Comprehensive best practices guide - **[docs/TECHNIQUES.md](docs/TECHNIQUES.md)** - Advanced prompt engineering techniques - **[docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)** - Common issues and solutions ### Examples & Templates - **[examples/EXAMPLES.md](examples/EXAMPLES.md)** - 10 real-world examples and templates --- ## 📚 What's Included ### Expertise Areas (7 Major Areas) 1. Prompt Writing Best Practices 2. Advanced Prompt Engineering Techniques 3. Custom Instructions & System Prompts 4. Prompt Optimization & Refinement 5. Anti-Patterns & Common Mistakes 6. Evaluation & Testing 7. Multimodal & Advanced Prompting ### Key Capabilities (8 Capabilities) 1. Prompt Analysis 2. Prompt Generation 3. Prompt Refinement 4. Custom Instruction Design 5. Best Practice Guidance 6. Anti-Pattern Recognition 7. Testing Strategy 8. Documentation ### Use Cases (9 Use Cases) 1. Refining vague or ineffective prompts 2. Creating specialized system prompts 3. Designing custom instructions for agents 4. Optimizing for consistency and reliability 5. Teaching prompt engineering best practices 6. Debugging prompt performance issues 7. Creating prompt templates for workflows 8. Improving efficiency and token usage 9. Developing evaluation frameworks --- ## 🎯 How to Use This Skill ### For Prompt Analysis ``` "Review this prompt and suggest improvements: [YOUR PROMPT] Focus on: clarity, specificity, format, and consistency." ``` ### For Prompt Generation ``` "Create a prompt that: - [Requirement 1] - [Requirement 2] - [Requirement 3] The prompt should handle [use cases]." ``` ### For Custom Instructions ``` "Design custom instructions for an agent that: - [Role/expertise] - [Key responsibilities] - [Behavioral guidelines]" ``` ### For Troubleshooting ``` "This prompt isn't working well: [PROMPT] Issues: [DESCRIBE ISSUES] How can I fix it?" ``` --- ## 📖 Documentation Structure ### BEST_PRACTICES.md (Comprehensive Guide) - Core principles (clarity, conciseness, degrees of freedom) - Advanced techniques (CoT, few-shot, XML, role-based, prefilling, chaining) - Custom instructions design - Skill structure best practices - Evaluation & testing frameworks - Anti-patterns to avoid - Workflows and feedback loops - Content guidelines - Multimodal prompting - Development workflow - Complete checklist ### TECHNIQUES.md (Advanced Methods) - Chain-of-Thought prompting with examples - Few-Shot learning (1-shot, 2-shot, multi-shot) - Structured output with XML tags - Role-based prompting - Prefilling responses - Prompt chaining - Context management - Multimodal prompting - Combining techniques - Anti-patterns ### TROUBLESHOOTING.md (Problem Solving) - 8 common issues with solutions - Debugging workflow - Quick reference table - Testing checklist ### EXAMPLES.md (Real-World Cases) - 10 practical examples - Before/after comparisons - Templates and frameworks - Optimization checklists --- ## ✅ Best Practices Summary ### Do's ✅ - Be clear and specific - Provide examples - Specify format - Define constraints - Test thoroughly - Document assumptions - Use progressive disclosure - Handle edge cases ### Don'ts ❌ - Be vague or ambiguous - Assume understanding - Skip format specification - Ignore edge cases - Over-specify constraints - Use jargon without explanation - Hardcode values - Ignore error handling --- ## 🚀 Getting Started ### Step 1: Read the Overview Start with **README.md** to understand what this skill provides. ### Step 2: Learn Best Practices Review **docs/BEST_PRACTICES.md** for foundational knowledge. ### Step 3: Explore Examples Check **examples/EXAMPLES.md** for real-world use cases. ### Step 4: Try It Out Share your prompt or describe your need to get started. ### Step 5: Troubleshoot Use **docs/TROUBLESHOOTING.md** if you encounter issues. --- ## 🔧 Advanced Topics ### Chain-of-Thought Prompting Encourage step-by-step reasoning for complex tasks. → See: TECHNIQUES.md, Section 1 ### Few-Shot Learning Use examples to guide behavio