skills.rest
KYRIE66nb
KYRIE66nbCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

writing-skills

Generate SKILL.md documentation with YAML frontmatter and RED-GREEN-REFACTOR validation.

Updated Apr 8, 2026
Search Tags:#tdd#documentation#rationalization#process-documentation#skill-writing#testing-skills
One-click install
npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill writing-skills-kyrie66nb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/KYRIE66nb/codex-omx-public-config/tree/main/home/.codex/skills/writing-skills
Command: npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill writing-skills-kyrie66nb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing skills provide a test-driven framework for documenting reusable patterns and techniques, ensuring consistency and verifiability across agents.

Core Features & Use Cases

  • Establishes a consistent SKILL.md structure (YAML frontmatter with name and description, plus a clear, multi-section body)
  • Guides crafting, testing, and deploying Skills using RED-GREEN-REFACTOR methodology
  • Enables reliable discovery and application of skills across agent types
  • Supports references, scripts, and assets for scalable Skill content

Quick Start

Create a new skill by adding a SKILL.md with YAML frontmatter that includes name and description, then write the guide body and validate it using the RED-GREEN-REFACTOR testing workflow.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write test-driven documentation for reusable skills?▼

Test-driven documentation for reusable skills is generated using a SKILL.md structure with YAML frontmatter and validated through a RED-GREEN-REFACTOR testing workflow to ensure deployment readiness and consistency.

What is the RED-GREEN-REFACTOR workflow for skill validation?▼

The RED-GREEN-REFACTOR workflow is a testing methodology that validates skill deployment readiness by guiding the creation, testing, and refinement of skill documentation to ensure safe distribution across agents.

What structure does a SKILL.md file need for safe agent distribution?▼

A SKILL.md file requires YAML frontmatter with name and description fields, followed by a multi-section body that can include optional references, scripts, and assets for scalable skill content distribution.

How do I add metadata fields like dependencies and components to a skill?▼

Metadata fields including dependencies, components, and toxicity checks are produced during the skill generation process to enforce a consistent SKILL.md structure and ensure safe distribution across different agent environments.

When do I need to use a test-driven framework for skill documentation?▼

A test-driven framework for skill documentation is needed when you want to ensure consistency and verifiability across agents, establishing a standardized structure that supports reliable discovery and application of reusable patterns.

Related Skills

Explore More Content & Communication Skills→
mguinadamguinada

vitest

Identify valid Skill Units and extract metadata into a YAML document.

Community
Advanced
datorresbdatorresb

skill-generator

Convert extraction patterns into standardized SKILL.md files for agent discovery.

Community
Advanced
randalmurphalrandalmurphal

test-driven-development

Guide developers through red-green-refactor cycles for test-first implementation.

Community
Basic
ccfccf

openapi-spec-generation

Generate and validate OpenAPI 3.1 specifications from design or code sources.

Community
Advanced