Can it automatically fix documentation errors?

Yes, when validation fails, the skill reflects on the error type—such as missing dependencies or type mismatches—and updates the skill's markdown file to include the necessary fixes.

Does it support browser-based testing?

Yes, it can run Playwright browser validation, including taking screenshots and checking the DOM, to ensure frontend skills function correctly in a real browser.

How does the sandbox environment work?

The skill initializes an independent Git repository in a sandbox directory where it tests code implementations, allowing for instant reverts and clean-state retries between iterations.

What is the main purpose of the improve-skill plugin?

It automates the process of testing and refining Claude Code skill markdown files to ensure they produce working, error-free code through an iterative implementation loop.

Skill Polish: Iterative Refinement Loop

Name: Skill Polish: Iterative Refinement Loop
Author: mattwoodco

bymattwoodco

•

생산성 및 워크플로

Refines and validates agent skill documentation through automated sandbox implementation and iterative error correction.

The improve-skill plugin provides an automated 'Skill Factory' workflow designed to transform draft markdown instructions into production-ready Claude Code skills. By iteratively implementing code in a dedicated sandbox environment, running comprehensive validation checks—including TypeScript, linting, and Playwright browser tests—and reflecting on failures, it ensures that every instruction and code snippet is accurate, functional, and ready for end-to-end deployment without manual intervention.

주요 기능

01Automated sandbox environment with Git-backed state management for instant reverts.

02Multi-tier validation including TypeScript checks, linting, build verification, and Playwright browser testing.

033 GitHub stars

04Integrated test generation for unit, integration, and end-to-end (E2E) scenarios.

05Standardized output format with automated versioning and dependency tracking.

06Intelligent error reflection and classification to automatically update skill documentation.

사용 사례

01Generating comprehensive test suites for documentation-driven development.

02Updating existing skills when underlying library APIs or framework versions change.

03Validating a new custom Claude Code skill to ensure code snippets are error-free.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mattwoodco/skills improve-skill

For use in Claude.ai and ChatGPT

Download Skill