improve-skill

Audit a skill's SKILL.md against canonical best-practices criteria.

Updated Jan 5, 2026
One-click install
npx skills add https://github.com/d3ming/dot-agents --skill improve-skill-d3ming
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improve-skill
Source: https://github.com/d3ming/dot-agents/tree/main/master/skills/improve-skill
Command: npx skills add https://github.com/d3ming/dot-agents --skill improve-skill-d3ming

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Audits and improves an existing skill against canonical best-practices criteria.

Core Features & Use Cases

  • Independent evaluation of a skill's frontmatter and body against the best-practices rubric.
  • Guided backfill: apply minimal changes and trigger a self-eval to validate improvements.
  • One-shot diff-based assessment that isolates changes and preserves original workflows.

Quick Start

Provide the target skill path or name as an argument to initiate an audit and improvement cycle.

Frequently Asked Questions about improve-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit and improve an existing Claude skill against best-practices criteria?

You can audit and improve a Claude skill by evaluating its SKILL.md and adjacent references against a best-practices rubric, processing the diff to generate actionable recommendations and a backfill plan.

What is a diff-based skill evaluation and how does it work?

A diff-based skill evaluation isolates changes made during an improvement cycle, comparing the original skill files against modified versions to produce a targeted verdict and validate updates via a self-eval script.

How do I run a self-eval script to validate skill improvements?

Run the evaluation script against the target skill's repository files to trigger a self-eval, which validates the applied minimal changes and confirms whether the skill meets the best-practices criteria.

Can I apply minimal changes to a skill without breaking the original workflow?

Yes, guided backfill applies minimal changes to the skill's frontmatter and body while preserving the original workflows, using a one-shot diff-based assessment to isolate and review modifications.

What files do I need to provide for a skill audit and improvement cycle?

You need access to the target skill's repository files, including the SKILL.md, adjacent references, the run-eval script, and evaluation prompts to produce a diff-based verdict and backfill plan.

Why does my skill audit return a failed verdict after running the evaluation?

A failed verdict indicates the skill's frontmatter or body does not meet the canonical best-practices criteria, requiring you to apply the generated backfill plan and re-run the self-eval to validate improvements.