Prompt Engineering Expert Skill

A comprehensive Claude Skill for prompt engineering expertise, custom instructions design, and prompt optimization.

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 and identify improvements
2. Prompt Generation - Create new prompts from scratch
3. Prompt Refinement - Iteratively improve prompts
4. Custom Instructions - Design specialized instructions for agents
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

🚀 Quick Start

Upload the Skill

1. Go to Claude.com
2. Click the "+" button next to the message input
3. Select "Upload a Skill"
4. Choose the prompt-engineering-expert folder
5. Start using it!

Basic Usage

"Review this prompt and suggest improvements:
[YOUR PROMPT]"

Advanced Usage

"Using your prompt engineering expertise:
1. Analyze this prompt: [PROMPT]
2. Identify issues
3. Suggest specific improvements
4. Provide a refined version
5. Explain what changed and why"

📁 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

📚 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

📖 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 Navigation

• Best Practices Guide
• Advanced Techniques
• Troubleshooting Guide
• Examples & Templates

🔗 Integration Points

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

📝 Version History

v1.0 (Current)

• Initial release
• Core expertise areas
• Best practices documentation
• Advanced techniques guide
• Troubleshooting guide
• Real-world examples

📚 External Resources

• Claude Documentation
• Anthropic Blog
• Claude Cookbooks
• Prompt Engineering Guide

🎉 Ready to Improve Your Prompts?

Start by sharing your current prompt or describing what you need help with!