prompt-engineering-expert
Advanced expert in prompt engineering, custom instructions design, and prompt optimization for AI agents
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
-
Prompt Analysis
- Review existing prompts
- Identify improvement opportunities
- Spot anti-patterns and issues
- Suggest specific refinements
-
Prompt Generation
- Create new prompts from scratch
- Design for specific use cases
- Ensure clarity and effectiveness
- Optimize for consistency
-
Custom Instructions
- Design system prompts
- Create agent instructions
- Define behavioral guidelines
- Set appropriate constraints
-
Best Practice Guidance
- Explain prompt engineering principles
- Teach advanced techniques
- Share real-world examples
- Provide implementation guidance
-
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
- Share your prompt or describe your need
- Receive analysis and recommendations
- Implement suggested improvements
- Test and validate
- 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
- Advanced Techniques
- Troubleshooting Guide
- Examples & Templates
Ready to improve your prompts? Start by sharing your current prompt or describing what you need help with!