How does this tool handle large SKILL.md files?

The refiner identifies files exceeding 500 lines and suggests moving detailed technical documentation to a separate 'references' directory to keep the primary context lean.

Can I approve changes before they are applied?

Yes, the refiner follows a multi-phase workflow where it presents a prioritized analysis and gathers user consent before implementing any refactoring or file changes.

Why should I avoid time estimates in skills?

Time estimates are strictly forbidden because LLMs cannot accurately track or predict real-world processing time, leading to hallucinations or inaccurate status updates.

What is a Claude Code Skill?

A Claude Code Skill is a specialized instruction set and configuration file that enhances Claude's ability to perform specific domain tasks within a development environment.

Claude Skill Refiner

Name: Claude Skill Refiner
Author: Przemocny

byPrzemocny

•

Herramientas para Desarrolladores

Audits and optimizes Claude Code skills by identifying structural issues, removing anti-patterns, and implementing prioritized improvements.

The Claude Skill Refiner is a specialized agent capability designed to maintain high standards for Claude Code skills. It performs deep structural audits, identifying critical issues like forbidden time estimates, oversized documentation, and poor workflow logic. By categorizing improvements into prioritized tiers (MUST, SHOULD, NICE), it provides a systematic framework for refactoring agent behavior, ensuring that custom skills remain concise, effective, and easy for the LLM to trigger and execute correctly.

Características Principales

017 GitHub stars

02Comprehensive verification reports including before-and-after metric comparisons

03Structural optimization to keep SKILL.md files under the recommended 500-line limit

04Automated audit for common skill anti-patterns like forbidden time estimates

05Interactive feedback loop ensuring all refactoring steps are user-approved

06Prioritized improvement reporting with MUST, SHOULD, and NICE classifications

Casos de Uso

01Refactoring monolithic 'everything-bagel' skills into streamlined, modular components

02Auditing a newly created skill for compliance with Claude Code best practices

03Fixing triggering issues where Claude fails to recognize or load a specific skill

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add przemocny/generic-skills general-skill-refiner

For use in Claude.ai and ChatGPT

Download Skill