Prompt Engineering Skill

Purpose

This skill enables comprehensive prompt engineering across multiple LLM models. Engineer, optimize, and refine prompts using established best practices. Create new prompts from scratch or improve existing ones for maximum effectiveness. Recommend optimal models based on specific requirements through interactive analysis.

Supported Models:

• Claude Opus 4.5, Sonnet 4.5, Haiku 4.5

• GPT 5.1, GPT 5.1 Codex

• Gemini Pro 3.0

When to Use This Skill

Invoke this skill when the user requests:

• Creating a new prompt for any supported LLM model

• Optimizing or improving an existing prompt

• Recommending which model to use for a specific task

• Comparing models for specific use cases

• Analyzing prompt weaknesses or issues

• Applying model-specific optimization techniques

• Migrating prompts between different models

• Troubleshooting poor model performance

Core Prompt Engineering Techniques

Six universal techniques apply across all models:

Technique When to Use Impact

XML Tags 3+ components, structured output High - clear separation

Role Prompting Domain expertise needed Medium - contextual knowledge

Clear & Direct Always (baseline) Critical - foundation

Multishot Prompting Format/style consistency High - 40-60% improvement

Chain of Thought Complex reasoning High - accuracy boost

Prompt Chaining Multi-stage workflows High - manages complexity

Technique Selection Matrix:

Task Type Recommended Techniques

Simple question/task Clear & Direct

Classification/extraction Clear & Direct + Examples

Analysis/reasoning Clear & Direct + Chain of Thought

Domain-specific task Clear & Direct + Role Prompting

Complex structured output Clear & Direct + XML Tags + Examples

Multi-step process Clear & Direct + Prompt Chaining

Supported Models Overview

Claude Family

Model Best For Speed Quality Cost

Opus 4.5 Research, creative, complex analysis Slow Highest $$$$$

Sonnet 4.5 Agentic coding, balanced production Fast High $$

Haiku 4.5 Classification, high-volume, latency-critical Very Fast Good $

OpenAI Family

Model Best For Speed Quality Cost

GPT 5.1 General-purpose, function calling Fast High $$

GPT 5.1 Codex Code generation, review, debugging Fast High (code) $$

Google Family

Model Best For Speed Quality Cost

Gemini Pro 3.0 Multimodal, context caching, Google integration Fast High $$

Prompt Engineering Workflow

Step 1: Understand Requirements

Gather essential information:

• Task purpose and success criteria

• Target model (if specified) or requirements for recommendation

• Input and output format requirements

• Constraints (length, style, format)

• Current issues (for optimization requests)

Step 2: Select or Recommend Model

If model specified: Load the corresponding model guide from reference/models/ .

If model not specified: Gather requirements via interactive dialog:

• Task type (code, analysis, creative, data, conversation)

• Priority (speed, quality, cost, balance)

• Context size requirements

• Special features needed (vision, function calling, JSON mode)

Then consult reference/comparisons/model-comparison-matrix.md and reference/comparisons/use-case-recommendations.md .

Step 3: Select Techniques

Always start with Clear & Direct (foundation technique).

Add based on needs:

• XML Tags: Complex structure, 3+ components

• Role Prompting: Domain expertise required

• Examples: Format consistency needed

• Chain of Thought: Reasoning tasks

• Prompt Chaining: Multi-stage workflows

Step 4: Load References

Load technique documentation from reference/techniques/ :

• Always load: 03-be-clear-and-direct.md

• Add as needed: Relevant technique files

Load model guide from reference/models/ :

• Target model optimization guide

Step 5: Draft or Optimize Prompt

For new prompts:

• Apply selected techniques systematically

• Structure with XML tags if appropriate

• Add examples if format matters

• Include model-specific optimizations

For optimization:

• Analyze current prompt against checklist

• Identify missing or misapplied techniques

• Apply fixes systematically

• Add model-specific optimizations

Step 6: Validate

Use reference/optimization/optimization-checklist.md to verify:

• Clarity and completeness

• Proper technique application

• Model-specific requirements met

• No common pitfalls

Step 7: Deliver

Provide:

• Complete prompt (ready to use)

• Technique explanation (what was applied and why)

• Usage instructions (how to use, variables to replace)

• Testing recommendations (how to verify it works)

Reference Documentation

Technique References

Detailed documentation for each technique:

• reference/techniques/01-xml-tags.md

• Structuring prompts

• reference/techniques/02-role-prompting.md

• System prompts and roles

• reference/techniques/03-be-clear-and-direct.md

• Foundation technique

• reference/techniques/04-multishot-prompting.md

• Using examples

• reference/techniques/05-chain-of-thought.md

• Step-by-step reasoning

• reference/techniques/06-prompt-chaining.md

• Multi-stage workflows

Model Guides

Model-specific optimization guides:

• reference/models/claude-opus-4.5.md

• Opus capabilities and optimizations

• reference/models/claude-sonnet-4.5.md

• Sonnet capabilities and optimizations

• reference/models/claude-haiku-4.5.md

• Haiku capabilities and optimizations

• reference/models/gpt-5.1.md

• GPT 5.1 capabilities and optimizations

• reference/models/gpt-5.1-codex.md

• Codex capabilities and optimizations

• reference/models/gemini-pro-3.0.md

• Gemini capabilities and optimizations

Comparison Resources

Cross-model analysis:

• reference/comparisons/model-comparison-matrix.md

• Capability comparison

• reference/comparisons/use-case-recommendations.md

• Task-based recommendations

Optimization Resources

Quality assurance and troubleshooting:

• reference/optimization/optimization-checklist.md

• Validation checklist

• reference/optimization/troubleshooting-guide.md

• Common issues and fixes

• reference/optimization/model-migration.md

• Adapting prompts between models

Example Library

Working examples by category:

• examples/classification-prompts.md

• Classification tasks

• examples/code-generation-prompts.md

• Code generation tasks

• examples/analysis-prompts.md

• Analysis and research tasks

• examples/creative-prompts.md

• Creative writing tasks

• examples/complex-workflow-prompts.md

• Multi-step workflows

Key Principles

1. Clarity is Foundational

Every prompt must have clear context, explicit instructions, defined success criteria, and specified output format. Without clarity, other techniques cannot compensate.

2. Match Technique to Task

Simple tasks need simple prompts. Complex tasks benefit from multiple techniques. Match complexity to actual need.

3. Model-Specific Optimization Matters

Each model has unique characteristics. Apply model-specific optimizations after general techniques for best results.

4. Test and Iterate

First drafts rarely perfect. Test with real inputs, identify failure modes, refine systematically.

5. Progressive Disclosure

Load detailed references only when needed. Start with core workflow, dive into specifics as required.

Quick Decision Guide

Which model for coding?

• Agentic/complex: Claude Sonnet 4.5

• Code generation focused: GPT 5.1 Codex

• Simple transforms: Claude Haiku 4.5

Which model for analysis?

• Complex research: Claude Opus 4.5

• General analysis: Claude Sonnet 4.5 or GPT 5.1

• Quick classification: Claude Haiku 4.5

Which model for creative work?

• Highest quality: Claude Opus 4.5

• Good quality, faster: Claude Sonnet 4.5

Which model for high volume?

• Speed critical: Claude Haiku 4.5

• Cost critical: Claude Haiku 4.5 or Gemini Pro 3.0

Which model for multimodal?

• Image understanding: Claude Opus 4.5 or Gemini Pro 3.0

• Vision + reasoning: Claude Opus 4.5

Output Formats

For New Prompts

Provide complete prompt, techniques applied, usage instructions, and testing recommendations.

For Optimization

Provide analysis of issues, improved prompt, changes made with explanations, and testing recommendations.

For Model Recommendations

Provide top 3 recommendations with match scores, comparison table, trade-off analysis, and prompt creation offer.

For Prompt Analysis

Provide strengths, weaknesses, techniques assessment, and prioritized improvement recommendations.