When should I trigger the skill-improve workflow?

You should use it when a skill feels shallow, provides generic advice, lacks specific implementation details, or when a self-evaluation score falls below an 8 out of 10.

What is a validation artifact?

A validation artifact is a tangible output—like a code component or a completed workflow—created using the improved skill to prove that the new instructions work as intended in a real-world scenario.

What does it mean to 'improve' a Claude Code skill?

Improving a skill involves moving beyond generic descriptions to include concrete values (like specific timeouts or constants), actionable decision trees, and integration with the user's specific development tools.

How does the research phase work?

The skill uses Ref MCP and WebFetch to read actual library documentation and source code, ensuring that the instructions are grounded in the current reality of the framework rather than old training data.

Skill Quality Optimizer

Name: Skill Quality Optimizer
Author: lnittman

bylnittman

0•

Productivity & Workflow

Optimizes and deepens Claude Code skills by transforming shallow instructions into actionable, data-driven expert systems.

The skill-improve utility is a meta-layer for Claude Code designed to elevate custom skills from generic descriptions to high-precision tools. It codifies a rigorous workflow of self-evaluation, primary source research, and multi-stage validation to ensure that every skill provides actionable decision trees, concrete constants, and tool-specific integrations. This skill is essential for power users who require their AI-driven workflows to be grounded in actual source code and verified implementation patterns rather than abstract philosophy.

Key Features

01Multi-model validation steps to ensure expert-level accuracy

02Logic-driven decision tree generation for complex if/then scenarios

03Artifact-based verification to prove real-world skill efficacy

04Systematic scoring rubric for evaluating skill depth and actionability

05Automated research workflow using MCP tools to extract primary source data

060 GitHub stars

Use Cases

01Transforming a basic, 'hallucinated' skill into a data-backed expert guide

02Fixing skills that provide vague or shallow advice during complex coding tasks

03Performing periodic audits and upgrades on a library of custom Claude skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lnittman/skills skill-improve

For use in Claude.ai and ChatGPT

Download Skill