skill-improver

Evaluate Claude Code skills against official best practices and generate improvement plans.

9|1|Updated Jan 15, 2016
One-click install
npx skills add https://github.com/wadackel/dotfiles --skill skill-improver-wadackel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-improver
Source: https://github.com/wadackel/dotfiles/tree/main/home/programs/claude/skills/skill-improver
Command: npx skills add https://github.com/wadackel/dotfiles --skill skill-improver-wadackel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Improves Claude Code skills by evaluating them against official best practices and producing actionable improvements.

Core Features & Use Cases

  • Evaluate frontmatter quality against standard guidelines and Agent Skills specs.
  • Generate an improvement plan covering description, workflow, progressive disclosure, and invocation control.
  • Apply approved changes to SKILL.md and related references, scripts, or assets as needed, with validation steps.

Quick Start

Run /skill-improver [skill-name] to begin an evaluation and improvement session.

Frequently Asked Questions about skill-improver

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

FAQPage Schema
How do I evaluate Claude Code skills against official best practices?

Skill evaluation involves checking frontmatter quality, description clarity, workflow design, and invocation control against standard guidelines, producing a structured improvement plan with actionable steps.

What is progressive disclosure in skill workflow design?

Progressive disclosure in skill workflow design is an evaluation criterion that structures SKILL.md content and references so users receive relevant details incrementally, improving organization and invocation control.

How do I generate an improvement plan for SKILL.md frontmatter and content quality?

You can generate an improvement plan by evaluating SKILL.md frontmatter and content quality against Agent Skills specs, which identifies gaps in triggering, description clarity, and structure, then produces actionable updates.

Can I apply approved skill improvements directly to references and scripts?

Yes, after generating an improvement plan, you can apply approved changes directly to SKILL.md and related references, scripts, or assets, followed by validation steps to ensure quality assurance standards are met.

Does skill-improver work with skills across different projects and teams?

Yes, skill-improver evaluates and improves skills across projects and teams by assessing triggering, description clarity, organization, and workflow design, ensuring consistent best practices and quality assurance throughout.

When should I not use an automated skill evaluation approach for Claude Code?

You should avoid automated skill evaluation when your SKILL.md lacks stable frontmatter or basic workflow design, as the evaluation relies on existing structure to generate accurate improvement plans and validation steps.