improve-skill

Orchestrate structured evaluation and improvement cycles for existing skills using audit evidence.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/patanet7/skillproof --skill improve-skill-patanet7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improve-skill
Source: https://github.com/patanet7/skillproof/tree/main/skills/improve-skill
Command: npx skills add https://github.com/patanet7/skillproof --skill improve-skill-patanet7

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Audits and enhances existing skills to reduce guessing and improve effectiveness by providing structured, evidence-based improvement workflows.

Core Features & Use Cases

  • Comprehensive audits (frontmatter, token budgets, sections, anti-patterns, best practices, and scripts)
  • End-to-end improvement planning (merge audit findings with workspace diagnoses to generate prioritized tasks)
  • Guided execution and validation (apply changes and re-run evaluations to verify impact)

Quick Start

Run the improvement workflow on a skill to generate a prioritized plan and validate changes with audits and diagnoses.

Frequently Asked Questions about improve-skill

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

FAQPage Schema
How do I audit existing skills using evidence-based evaluation?

Skill audits evaluate frontmatter, token budgets, sections, and scripts to identify anti-patterns and generate JSON or Markdown reports. This evidence-based evaluation identifies failures and improvement areas across skill domains.

What is the best way to plan improvements after a skill audit?

Improvement planning merges audit findings with workspace diagnoses to generate prioritized tasks. This structured planning reduces guessing by relying on evidence from both audits and testing workspaces.

How do I validate skill changes after applying improvements?

Validate skill changes by applying improvements and re-running evaluation scripts in testing workspaces. This guided execution and validation cycle verifies impact by re-validating outcomes using predefined Python modules.

Do I need SKILL.md frontmatter to run a skill evaluation workflow?

Yes, the evaluation workflow requires SKILL.md frontmatter. The process needs access to frontmatter, audit reports, workspace diagnoses, and evaluation scripts to orchestrate structured improvement cycles.

What limitations exist when diagnosing skills with Python evaluation scripts?

A limitation is the dependency on predefined Python modules within the scripts directory. The workflow cannot function without access to a skill's frontmatter, audit reports, and workspace diagnoses.