write-skill

Create SKILL.md files with mandatory frontmatter and standard sections.

5|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/sambeau/kanbanzai --skill write-skill-sambeau
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-skill
Source: https://github.com/sambeau/kanbanzai/tree/main/.kbz/skills/write-skill
Command: npx skills add https://github.com/sambeau/kanbanzai --skill write-skill-sambeau

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a clear, process-driven approach to authoring SKILL.md documents that meet the project's conventions, ensuring consistent structure, terminology, and evaluable content.

Core Features & Use Cases

  • Enforces mandatory frontmatter fields (name, description with expert and natural registers, triggers, roles, stage, constraint_level)
  • Organizes content into standard sections: Vocabulary, Anti-Patterns, Procedure, Output Format, Examples, Evaluation Criteria, and Questions
  • Guides creation of a dual-register description, 15–30 domain terms, 5–10 anti-patterns with Detect/BECAUSE/Resolve, and a structured evaluation rubric
  • Supports reference material through a references/ directory when content grows

Quick Start

Draft a new SKILL.md following the published CONVENTIONS in .kbz/skills/CONVENTIONS.md. Use the frontmatter fields and maintain the required structure.

Frequently Asked Questions about write-skill

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

FAQPage Schema
What is a SKILL.md document and when do I need it for documentation conventions?

A SKILL.md document standardizes Skill Unit creation by enforcing mandatory frontmatter and structured sections like vocabulary, anti-patterns, and procedures to ensure consistent documentation conventions across projects.

How do I write a SKILL.md file with proper frontmatter and structure?

To write a SKILL.md file, draft the content following published conventions by including six mandatory frontmatter fields, 15-30 vocabulary terms, 5-10 anti-patterns, a 5-10 step procedure, and an evaluation rubric.

Does a SKILL.md require evaluation criteria and retrieval anchors?

Yes, a SKILL.md requires evaluation criteria and retrieval anchors. It must also include anti-patterns with Detect, BECAUSE, and Resolve structures, alongside an output template and examples for rigorous evaluation.

What's the best way to structure anti-patterns in skill documentation?

The best way to structure anti-patterns in skill documentation is to define 5-10 items using a Detect, BECAUSE, and Resolve format, ensuring clear identification, reasoning, and remediation for each pattern.

Can I use a references directory when authoring skill documentation?

Yes, you can use a references directory to support your SKILL.md file. This approach helps organize reference material when content grows beyond the standard document sections.

Why does my skill documentation need a dual-register description?

A dual-register description is needed in skill documentation to satisfy mandatory frontmatter conventions, providing both an expert register and a natural register to accurately define the skill's scope and triggers.