skill-improver

Audit and refactor SKILL.md files for LLM-first standard compliance.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the need to improve, audit, refactor, and enhance existing SKILL.md files within an AI skill repository, ensuring quality and compliance with best practices.

Core Features & Use Cases

  • Skill Audit: Systematically reviews and improves SKILL.md files for clarity, structure, and adherence to style guides.
  • Refactoring: Refactors existing skills to optimize performance, readability, and adherence to the LLM-first philosophy.
  • Quality Control: Ensures skills are of high quality and ready for production use.

Quick Start

Use the skill-improver to audit the SKILL.md file located at 'path/to/skill'.

Frequently Asked Questions about skill-improver

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

FAQPage Schema
How do I audit an existing SKILL.md file for LLM-first compliance?

To audit a SKILL.md file for LLM-first compliance, use the skill-improver to systematically review metadata completeness, rule clarity, and operational effectiveness against the standard skill style guide.

What is the best way to refactor LLM-first skills for production quality?

Refactoring LLM-first skills for production quality involves optimizing performance, readability, and adherence to the LLM-first philosophy, systematically enhancing existing SKILL.md files for repository maintainers.

When do I need to run a skill audit on my SKILL.md files?

You need to run a skill audit on SKILL.md files when repository maintainers require high-quality skill development, ensuring existing skills have complete metadata and clear rules for production readiness.

Does the skill-improver check metadata completeness and rule clarity?

Yes, the skill-improver checks metadata completeness and rule clarity, operating on defined criteria to systematically review and improve SKILL.md files for adherence to style guides.

Can I use this skill audit tool to review multiple SKILL.md files in a repository?

You can use this skill audit tool to review SKILL.md files located at specified paths, ensuring each file meets style guide criteria and operational effectiveness for production use.

Why does my existing SKILL.md file fail quality control checks?

Your existing SKILL.md file may fail quality control checks due to incomplete metadata, unclear rules, or lack of adherence to the LLM-first skill standard, requiring systematic refactoring.