One-click install
npx skills add https://github.com/pascalandy/dotfiles --skill skill-creator-refiner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator-refiner
Source: https://github.com/pascalandy/dotfiles/tree/main/dot_config/opencode/skill/skill-creator-refiner
Command: npx skills add https://github.com/pascalandy/dotfiles --skill skill-creator-refiner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the challenge of reliably refining and validating Skills before they are deployed, ensuring consistency, testability, and resistance to regression.

Core Features & Use Cases

  • Structured RED-GREEN-REFACTOR workflow: captures baseline failures, builds minimal skills, and closes loopholes.
  • Frontmatter validation and testing discipline: enforces YAML frontmatter integrity and post-deployment verification.
  • Guided deployment checks: provides a repeatable process to publish high-quality Skills with minimal risk.
  • Documentation-first approach: encourages documenting decisions, rationalizations, and red flags for future audits.

Quick Start

  1. Identify a candidate Skill directory, ensure it contains SKILL.md at the root with frontmatter.
  2. Run the RED phase by documenting baseline failures without the Skill.
  3. Implement the GREEN Skill, run tests, and perform REFACTOR iterations until no new rationalizations appear.

Frequently Asked Questions about skill-creator-refiner

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

FAQPage Schema
How do I validate skill frontmatter and test for regression before deployment?

To validate skill frontmatter and test for regression before deployment, apply a structured RED-GREEN-REFACTOR workflow that enforces YAML integrity, captures baseline failures, and performs post-deployment verification checks.

What is the RED-GREEN-REFACTOR workflow for skill refinement?

The RED-GREEN-REFACTOR workflow for skill refinement is a testing discipline where RED captures baseline failures without the skill, GREEN implements minimal skills to pass tests, and REFACTOR closes loopholes until no new rationalizations appear.

How do I use test-driven development to close loopholes in skill documentation?

To close loopholes in skill documentation using test-driven development, iteratively run REFACTOR phases and document decisions, rationalizations, and red flags for future audits until the deployment checks pass without new rationalizations.

Does skill refinement require a specific directory structure?

Skill refinement requires a candidate skill directory containing a SKILL.md file at the root with valid YAML frontmatter to initiate the workflow-management process and enforce documentation-testing discipline.

What is the best way to ensure deployment quality for new skills?

The best way to ensure deployment quality for new skills is to enforce a documentation-first approach alongside frontmatter validation, capturing baseline failures and performing guided deployment checks prior to publishing.