writing-skills

Enforce a test-driven workflow for authoring SKILL.md files with YAML frontmatter.

66|20|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/cooker/wxHm --skill writing-skills-cooker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/cooker/wxHm/tree/main/.cursor/skills/writing-skills
Command: npx skills add https://github.com/cooker/wxHm --skill writing-skills-cooker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing Skills documentation often lacks discipline and a repeatable process. This Skill provides a test-driven framework for authoring SKILL.md with a minimal frontmatter and well-structured body, ensuring discoverability and reliability.

Core Features & Use Cases

  • Enforces YAML frontmatter with name and description in SKILL.md to support Claude discovery.
  • Promotes progressive disclosure by referencing additional materials (scripts, references, assets) only when needed.
  • Guides writers to craft evidence-based, test-driven content and checklists that validate skill effectiveness.
  • Provides templates and examples to accelerate consistent skill creation.

Quick Start

To begin, create a new Skill directory named after your skill, add an SKILL.md with the required YAML frontmatter (name and description), and write a concise description body following the Skill structure. Then add optional subfolders as needed (scripts/, references/, assets/) and link them from SKILL.md as required.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I create a SKILL.md file with the correct YAML frontmatter?

To create a SKILL.md file, add YAML frontmatter with the required name and description fields, then write a concise body following the skill structure to support Claude discovery.

What is test-driven skill writing and how does it validate documentation?

Test-driven skill writing enforces a repeatable authoring process by guiding writers to craft evidence-based content and checklists that validate skill effectiveness before deployment.

How do I structure a skill directory using scripts, references, and assets folders?

Structure a skill directory by creating a main folder with an SKILL.md file, then add optional scripts/, references/, and assets/ subfolders and link them from SKILL.md as needed using progressive disclosure.

Do I need any dependencies or scripts to start writing Skills?

No dependencies are required to start writing Skills; you only need a new directory with an SKILL.md file containing the required YAML frontmatter and a well-structured body.

What is the best way to ensure consistent Skill documentation across multiple authors?

The best way to ensure consistent Skill documentation is adopting a test-driven workflow that enforces required YAML frontmatter and provides templates for structuring the SKILL.md body.