skills.rest
full-stack-biz
full-stack-bizOFFICIAL
Explore all skills by this author →
WebsiteGitHub

skill-refiner

Refine Claude Code skills by validating frontmatter and relocating content between SKILL.md and references.

26|2|Updated Jan 16, 2026
Search Tags:#refinement#validation#frontmatter#references#production-readiness#movement-pattern
One-click install
npx skills add https://github.com/full-stack-biz/claude-skills-toolkit --skill skill-refiner
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-refiner
Source: https://github.com/full-stack-biz/claude-skills-toolkit/tree/main/skills/skill-refiner
Command: npx skills add https://github.com/full-stack-biz/claude-skills-toolkit --skill skill-refiner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Refines Claude Code skills to improve clarity, efficiency, and production readiness.

Core Features & Use Cases

  • Quality-focused refinement: improves structure, activation clarity, and adherence to best practices without changing core functionality.
  • Validation-driven improvements: evaluates and strengthens frontmatter, references, tool scoping, and overall documentation for reliability.
  • Safe content relocation: enforces the Movement Pattern and preservation gates to relocate content without breaking links or losing information.

Quick Start

Use this skill to refine an existing skill like skill-creator: select the target skill, confirm scope, and let Claude perform structured refinement steps, then review and apply changes.

Frequently Asked Questions about skill-refiner

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

FAQPage Schema
How do I refine Claude Code skills for production readiness?▼

To refine Claude Code skills for production readiness, you validate frontmatter, enforce structure, and orchestrate content moves between SKILL.md and references/ directories without losing existing functionality.

What is the Movement Pattern for managing skill references?▼

The Movement Pattern is a safe content relocation strategy using the CREATE → LINK → DELETE sequence. It ensures that moving content between SKILL.md and references/ does not break links or lose information.

How do I validate frontmatter and activation triggers in existing skills?▼

Validating frontmatter and activation triggers requires running structured validation phases that evaluate skill structure, tool scoping, and documentation reliability to improve overall clarity and efficiency.

Can I restructure skill documentation without breaking references?▼

Yes, you can safely restructure documentation by applying four Preservation Gates alongside the Movement Pattern. This process validates content integrity before, during, and after relocation to prevent link breakage.

Does skill refinement alter the core functionality of the target skill?▼

No, skill refinement focuses strictly on quality-focused improvements to clarity, structure, and activation triggers. It enforces preservation gates to ensure no core functionality is lost during the process.

Related Skills

Explore More Software Engineering Skills→
dobrinz123dobrinz123

skill-creator

Create and refine SKILL.md files with test prompts and eval workspaces.

Community
Advanced
granietgraniet
247

kheish-daemon-live-validation

Output the deterministic readiness marker for Kheish daemon live validation tests.

Community
Basic
hashintelhashintel
1.6k

skill-creator

Generate and validate SKILL.md frontmatter and guidance for agent skills.

Official
Advanced
williamzujkowskiwilliamzujkowski
18

docs-rewrite

Audit, rewrite, and validate existing technical documentation.

Community
Intermediate