Skill Perfection
Use this skill when you need to QA audit and fix a plugin skill file. Provides a methodology for verifying skill content against official documentation, fixing issues in-place, and producing verification reports.
Install
/plugin marketplace add OmidZamani/dspy-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add OmidZamani/dspy-skills --skill skill-perfectiongit clone --depth 1 https://github.com/OmidZamani/dspy-skills.git /tmp/dspy-skills
mkdir -p ~/.claude/skills
cp -r /tmp/dspy-skills/.claude/skills-skill-perfection ~/.claude/skills/skill-perfectionPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Skill Perfection
A systematic process for auditing and fixing plugin skills in a single pass.
## Core Principle
**Audit + Fix in One Pass**: When you find an issue, fix it immediately, then continue. This eliminates redundant research and multiple iterations.
## Process Overview
```
[Optional Preflight] → Audit+Fix (single pass) → Verify (spot-check) → Report
```
## Phase 1: Preflight (Optional, Advisory)
A Python-based preflight script is bundled for **Python-heavy skills only**.
### When to Use Preflight
| Skill Content | Use Preflight? |
|---------------|----------------|
| Mostly Python code blocks | ✅ Yes |
| Mixed Python + other languages | ⚠️ Optional (Python blocks only) |
| Non-Python (JS, Rust, Go, etc.) | ❌ Skip, go to Phase 2 |
| Skill about the preflight script itself | ❌ Skip (conflict of interest) |
### Running Preflight
```bash
uv run python ${SKILL_DIR}/scripts/preflight.py <path-to-skill.md> --no-urls
```
### Interpreting Results
| Result | Action |
|--------|--------|
| `✅ PASSED` | Good signal. Proceed to Phase 2, trust syntax is valid. |
| `❌ FAILED` with clear errors (syntax error at line X) | Fix those specific issues, then proceed to Phase 2. |
| `❌ FAILED` with confusing/many errors | **Ignore preflight entirely.** Proceed to Phase 2, let LLM verify. |
| Script crashes or hangs | **Ignore preflight entirely.** Proceed to Phase 2. |
### Key Rule: Preflight is AdvisoryDetails
- Skill name
skill-perfection- Repository
- OmidZamani/dspy-skills
- Path
.claude/skills-skill-perfection/SKILL.md- License
- MIT
- Repo updated
- 23 June 2026
- Listed in
- heilcheng/awesome-agent-skills
FAQ
What does the Skill Perfection skill do?
Use this skill when you need to QA audit and fix a plugin skill file. Provides a methodology for verifying skill content against official documentation, fixing issues in-place, and producing verification reports.
How do I install the Skill Perfection skill?
Claude Code plugin: /plugin marketplace add OmidZamani/dspy-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Skill Perfection popular?
It lives in OmidZamani/dspy-skills, which has 125 GitHub stars and 13 forks, and is included in 1 curated skill list.
Related skills
Dspy Adapters Multimodal
125OmidZamani/dspy-skills
Use for DSPy adapter selection, JSONAdapter, XMLAdapter, ChatAdapter, native function calling, structured outputs, and multimodal inputs like dspy.Image or dspy.Audio.
Dspy Advanced Module Composition
125OmidZamani/dspy-skills
Use for composing DSPy modules with Ensemble, MultiChainComparison, ensemble voting, sequential pipelines, and multi-program workflows.
Dspy Better Together
125OmidZamani/dspy-skills
Use for BetterTogether, prompt plus weight optimization, fine-tuning sequences, and strategy chains like p -> w -> p.
Agent Role Design
207Owl-Listener/ai-design-skills
Defining what each agent does, knows, and owns in a multi-agent system.
Dspy React Agent Builder
125OmidZamani/dspy-skills
Use for ReAct agents, tool-calling agents, dspy.ReAct, multi-step reasoning and acting, and GEPA agent optimization.
Behavioral Consistency
207Owl-Listener/ai-design-skills
Ensuring the AI behaves predictably across sessions, edge cases, and modalities.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.