skill-maker

Create and validate Claude skills with a test-driven RED-GREEN-REFACTOR workflow.

2|1|Updated Nov 17, 2025
One-click install
npx skills add https://github.com/xbklairith/kisune --skill skill-maker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-maker
Source: https://github.com/xbklairith/kisune/tree/main/dev-workflow/skills/skill-maker
Command: npx skills add https://github.com/xbklairith/kisune --skill skill-maker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured, test-driven approach to authoring Claude Skills. It emphasizes failing-test-first development, iterative content creation, and bundled resources to ensure skills are robust and reusable.

Core Features & Use Cases

  • Structured Skill Creation: YAML frontmatter, body content, and resources.
  • Red-Green-Refactor: Baseline tests and iterative improvements.
  • Bundled Resources: Optional scripts/references/assets for deterministic behavior.

Quick Start

Create or edit a skill directory, add a properly formatted SKILL.md, then run the Skill Maker to validate with tests.

Frequently Asked Questions about skill-maker

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

FAQPage Schema
How do I create a Claude skill using test-driven development?

Test-driven development for skill creation starts with writing failing tests, then building the skill to pass them. Use the red-green-refactor workflow: define test cases first, implement the SKILL.md with YAML frontmatter and structured Markdown, bundle resources, then validate against your test suite iteratively.

What structure does a Claude skill require?

A Claude skill requires a SKILL.md file with YAML frontmatter (metadata), body content (instructions), and optional bundled resources like scripts or reference assets. Frontmatter validation enforces mandatory fields and optional metadata; the body uses structured Markdown for clarity and reusability across skill domains.

Can I validate my skill before publishing it?

Yes. Run pressure tests through the skill-maker workflow to validate frontmatter, metadata compliance, and instruction structure. These tests catch configuration errors and ensure your skill behaves consistently before use.

How do I make my Claude skill reusable across different use cases?

Structure your skill with modular instructions, clear separation of concerns, and bundled resources that support multiple capability domains. Document input/output expectations in frontmatter metadata and use consistent Markdown formatting to enable reuse and editing by others.

What's the difference between writing a skill ad-hoc versus using a test-driven approach?

Test-driven skill authoring enforces frontmatter validation, metadata consistency, and deterministic behavior through repeatable testing. Ad-hoc approaches risk inconsistent structure, missing metadata, and unpredictable behavior. Red-green-refactor ensures skills are robust and maintainable from the start.

Do I need to use bundled resources in my skill?

Bundled resources are optional but recommended for deterministic behavior. They include scripts, references, or assets that make your skill reproducible and reduce ambiguity. Use them when your skill depends on external tools or consistent data formats.