How do I install the Prompt Optimization skill?

Run npx skillmds@latest add diegosouzapw/prompt-optimization in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Prompt Optimization safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Prompt Optimization?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Prompt Optimization free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Prompt Optimization?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Prompt Optimization by diegosouzapw

Name: Prompt Optimization
Rating: 4.2 (5 reviews)
Author: diegosouzapw

Prompt Optimization

Guidelines for creating effective prompts that maximize AI understanding and response quality. Helps developers craft clear, specific, actionable prompts with appropriate context for optimal AI assistance.

diegosouzapw Updated Sep 8, 2026 54 repo stars

File contents

Prompt Optimization Guide

Comprehensive guide for crafting high-quality prompts that maximize AI understanding and effectiveness. Contains best practices for clarity, context, structure, and tactical approaches to prompt engineering.

When to Apply

Reference these guidelines when:

Crafting initial prompts for complex tasks
Improving AI response quality and accuracy
Training team members on effective AI interaction
Iterating on prompts that aren't producing desired results
Creating reusable prompt templates

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	Clarity and Precision	CRITICAL	`clarity-`
2	Context Provisioning	CRITICAL	`context-`
3	Structure and Formatting	HIGH	`structure-`
4	Tactical Tips	MEDIUM	`tactical-`
5	Examples and Patterns	MEDIUM	`example-`
6	Advanced Techniques	HIGH	`advanced-`

Quick Reference

1. Clarity and Precision (CRITICAL)

clarity-specific-language - Use precise terminology instead of vague concepts
clarity-define-terms - Define technical terms or acronyms
clarity-clear-objectives - State specific goals and expectations
clarity-avoid-ambiguity - Eliminate vague pronouns and references

2. Context Provisioning (CRITICAL)

context-project-info - Include relevant project background
context-current-state - Describe current situation and constraints
context-goals-outcomes - Specify desired outcomes and success criteria
context-priorities-tradeoffs - Explain important priorities and trade-offs

3. Structure and Formatting (HIGH)

structure-segmentation - Break complex requests into logical sections
structure-order-of-info - Present information in logical sequence
structure-formatting-visual - Use markdown for readability
structure-sequential-steps - Number steps when sequence matters

4. Tactical Tips (MEDIUM)

tactical-role-definition - Assign specific roles to AI
tactical-expectation-setting - Explicitly state output format
tactical-feedback-loops - Include iteration and refinement cycles
tactical-constraints-clarification - Clearly define limitations

5. Examples and Patterns (MEDIUM)

example-good-vs-bad - Compare effective and ineffective approaches
example-template-patterns - Provide reusable prompt templates
example-industry-specific - Show domain-specific best practices
example-error-patterns - Highlight common mistakes to avoid

6. Advanced Techniques (HIGH)

How to Use

Follow the systematic approach outlined in USAGE.md for consistent prompt optimization results.

---name: prompt-optimizationdescription: Guidelines for creating effective prompts that maximize AI understanding and response quality. Helps developers craft clear, specific, actionable prompts with appropriate context for optimal AI assistance.license: MIT---# Prompt Optimization GuideComprehensive guide for crafting high-quality prompts that maximize AI understanding and effectiveness. Contains best practices for clarity, context, structure, and tactical approaches to prompt engineering.## When to ApplyReference these guidelines when:- Crafting initial prompts for complex tasks- Improving AI response quality and accuracy- Training team members on effective AI interaction- Iterating on prompts that aren't producing desired results- Creating reusable prompt templates## Rule Categories by Priority| Priority | Category | Impact | Prefix ||----------|----------|--------|--------|| 1 | Clarity and Precision | CRITICAL | `clarity-` || 2 | Context Provisioning | CRITICAL | `context-` || 3 | Structure and Formatting | HIGH | `structure-` || 4 | Tactical Tips | MEDIUM | `tactical-` || 5 | Examples and Patterns | MEDIUM | `example-` || 6 | Advanced Techniques | HIGH | `advanced-` |## Quick Reference### 1. Clarity and Precision (CRITICAL)- `clarity-specific-language` - Use precise terminology instead of vague concepts- `clarity-define-terms` - Define technical terms or acronyms- `clarity-clear-objectives` - State specific goals and expectations- `clarity-avoid-ambiguity` - Eliminate vague pronouns and references### 2. Context Provisioning (CRITICAL)- `context-project-info` - Include relevant project background- `context-current-state` - Describe current situation and constraints- `context-goals-outcomes` - Specify desired outcomes and success criteria- `context-priorities-tradeoffs` - Explain important priorities and trade-offs### 3. Structure and Formatting (HIGH)- `structure-segmentation` - Break complex requests into logical sections- `structure-order-of-info` - Present information in logical sequence- `structure-formatting-visual` - Use markdown for readability- `structure-sequential-steps` - Number steps when sequence matters### 4. Tactical Tips (MEDIUM)- `tactical-role-definition` - Assign specific roles to AI- `tactical-expectation-setting` - Explicitly state output format- `tactical-feedback-loops` - Include iteration and refinement cycles- `tactical-constraints-clarification` - Clearly define limitations### 5. Examples and Patterns (MEDIUM)- `example-good-vs-bad` - Compare effective and ineffective approaches- `example-template-patterns` - Provide reusable prompt templates- `example-industry-specific` - Show domain-specific best practices- `example-error-patterns` - Highlight common mistakes to avoid### 6. Advanced Techniques (HIGH)## How to UseFollow the systematic approach outlined in USAGE.md for consistent prompt optimization results.

Frequently asked questions