skills.rest
Cygnusfear
CygnusfearCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

writing-skills

Apply test-driven development to skill documentation with RED-GREEN-REFACTOR validation.

5|3|Updated Oct 23, 2025
Search Tags:#documentation#TDD#skill authoring#CSO#testing-skills
One-click install
npx skills add https://github.com/Cygnusfear/claude-stuff --skill writing-skills-cygnusfear
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/Cygnusfear/claude-stuff/tree/main/skills/writing-skills
Command: npx skills add https://github.com/Cygnusfear/claude-stuff --skill writing-skills-cygnusfear

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Writing Skills apply test-driven development to process documentation, ensuring skills are discoverable, accurate, and robust under pressure.

Core Features & Use Cases

  • Skill Documentation – Provides structured templates for SKILL.md, including frontmatter and sections.
  • CSO Guidance – Claude Search Optimization: trigger phrases, keywords, and concise frontmatter.
  • Testing Patterns – RED-GREEN-REFACTOR-style validation for skill documentation.
  • Heavy References – Supporting examples, templates, and best practices.

Quick Start

Draft a SKILL.md for a new Skill, write its 3-section description, then run TDD-style tests to ensure the skill is discoverable and usable.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write documentation for skills that passes testing?▼

Test-driven development for skill documentation ensures your SKILL.md meets discovery and accuracy standards. Write your 3-section description, then run RED-GREEN-REFACTOR validation cycles to verify the skill is discoverable and performs reliably across models under pressure.

What is Claude Search Optimization and why does it matter for skill documentation?▼

Claude Search Optimization (CSO) applies structured frontmatter, trigger phrases, and keyword alignment to make skills discoverable. Proper CSO ensures your skill's documentation surfaces correctly in search results and users can find it when they need it.

Can I use TDD patterns to validate skill behavior across different models?▼

Yes. This Skill applies test-driven development specifically to capture baseline failures, pressure-test with subagents, and verify consistent skill behavior across Claude models—catching deployment issues before production.

What components does skill documentation include?▼

Skill documentation requires SKILL.md with YAML frontmatter, structured sections for description and use cases, and alignment with CSO guidance. This Skill provides templates, references, and best practices for all components.

How do I know if my skill documentation is production-ready?▼

Documentation is production-ready when it passes RED-GREEN-REFACTOR cycles, meets YAML frontmatter constraints, satisfies CSO requirements, and validation confirms the skill behaves consistently and is reliably discoverable.

Related Skills

Explore More Content & Communication Skills→
ndhananjndhananj
1

django-tdd

Set up Test-Driven Development for Django with pytest and factory_boy.

Community
Advanced
RelevanceAIRelevanceAI
2

eval

Generate and execute YAML-configured test cases for Relevance AI agents.

Official
Advanced
jayhjenkinsjayhjenkins
1

create-skill

Create Claude skills with test-driven RED-GREEN-REFACTOR workflows and CSO-optimized frontmatter.

Community
Advanced
scanadyscanady

skill-writer

Guide AI agent skill authoring with RED-GREEN-REFACTOR TDD cycles.

Community
Advanced