skill-improver

Automate iterative quality assessment and refinement of SKILL.md files.

Updated Nov 23, 2025
One-click install
npx skills add https://github.com/manuelbrandner85/Weltenbibliothekapp --skill skill-improver-manuelbrandner85
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-improver
Source: https://github.com/manuelbrandner85/Weltenbibliothekapp/tree/main/.agents/skills/skill-improver
Command: npx skills add https://github.com/manuelbrandner85/Weltenbibliothekapp --skill skill-improver-manuelbrandner85

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the challenge of maintaining high-quality, reliable AI skills by automating the review and improvement cycle, ensuring that every skill meets strict operational standards.

Core Features & Use Cases

  • Automated Quality Review: Uses the skill-reviewer agent to identify critical, major, and minor issues in your SKILL.md files.
  • Iterative Refinement: Guides the AI through a structured loop to fix issues, categorize severity, and verify improvements.
  • Use Case: When developing a new skill, use this to automatically catch missing frontmatter, vague descriptions, or broken references before deploying it to your team.

Quick Start

Trigger the skill-improver by asking the assistant to improve the quality of the skill located in the current directory.

Frequently Asked Questions about skill-improver

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

FAQPage Schema
How do I automate the quality review of my AI skill definitions?

Automating AI skill quality review involves using an agent to iteratively assess and refine SKILL.md files. This process targets YAML frontmatter correction, documentation clarity, and structural integrity through a structured validation loop.

What is the best way to fix YAML frontmatter and structural issues in AI skills?

Fixing YAML frontmatter and structural issues in AI skills is best handled by an iterative refinement loop. This approach categorizes issue severity and guides the AI through automated corrections to ensure operational standards are met.

Do I need the skill-reviewer agent to refine SKILL.md files?

Yes, the skill-reviewer agent is required to execute the validation and improvement loop for SKILL.md files. It identifies critical, major, and minor issues, while the plugin-dev plugin is also required to run the automation.

How does iterative refinement work for AI skill documentation?

Iterative refinement for AI skill documentation works by running automated quality checks that catch missing frontmatter or vague descriptions. The AI undergoes a structured loop to fix categorized issues and verify improvements before deployment.

Can I use an automated loop to catch missing frontmatter before deploying AI skills?

Yes, you can use an automated loop to catch missing frontmatter and vague descriptions before deploying AI skills. This automated quality review validates definitions and ensures every skill meets strict operational standards prior to release.