skill-refine

Audits Claude skills and proposes refinements aligned with Anthropic's best-practices standards.

1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/maxenko/claude-skills --skill skill-refine-maxenko
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-refine
Source: https://github.com/maxenko/claude-skills/tree/main/skill-refine
Command: npx skills add https://github.com/maxenko/claude-skills --skill skill-refine-maxenko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audits and refines existing Claude skills to meet Anthropic's official best-practices standards, improving reliability and alignment.

Core Features & Use Cases

  • Conducts frontmatter validation, structural hygiene, and domain-depth checks against the official checklist.
  • Produces concrete improvement recommendations and domain-research additions to keep skills current.
  • Supports phase-by-phase refinement workflows while preserving original skill intent.

Quick Start

Validate and refine a target skill by applying the Phase 1–5 process to its SKILL.md and references.

Frequently Asked Questions about skill-refine

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

FAQPage Schema
How do I audit an existing Claude skill against Anthropic best-practices standards?▼

To audit a Claude skill against Anthropic best-practices standards, the skill validates frontmatter, structural hygiene, references, and domain-depth against the official checklist to ensure compliance and reliability.

What is the best way to refine a Claude skill without changing its original intent?▼

The best way to refine a Claude skill while preserving its intent is to apply a phase-by-phase workflow. This proposes concrete, minimally invasive changes to improve structure and domain-depth without altering the original purpose.

How do I check if my Claude skill frontmatter and references meet the official checklist?▼

Check Claude skill frontmatter and references by running a Phase 1-5 refinement process on the SKILL.md. This validates structural hygiene and produces concrete improvement recommendations for checklist compliance.

Can I add domain-research to an existing Claude skill to improve its reliability?▼

Yes, you can add domain-research to an existing Claude skill to improve reliability. The refinement process proposes domain-research additions and concrete improvements to keep skills current with Anthropic standards.

Does Claude skill refinement require any specific dependencies or environments?▼

Claude skill refinement requires no specific dependencies. It operates directly on the target skill's SKILL.md and references, auditing them against the official best-practices checklist to produce actionable improvements.

Why does my Claude skill fail the Anthropic best-practices audit?▼

A Claude skill fails the Anthropic best-practices audit due to frontmatter errors, poor structural hygiene, missing references, or insufficient domain-depth. The refinement process identifies these gaps and proposes minimally invasive fixes.