skills.rest
lucasreydman
lucasreydmanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

writing-skills

Codify disciplined skill-writing practices with RED-GREEN-REFACTOR and frontmatter validation.

Updated Mar 23, 2026
Search Tags:#workflow#tdd#documentation#test-driven-development#skill-writing#rationalizations
One-click install
npx skills add https://github.com/lucasreydman/lloyd --skill writing-skills-lucasreydman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/lucasreydman/lloyd/tree/main/skills/superpowers/skills/writing-skills
Command: npx skills add https://github.com/lucasreydman/lloyd --skill writing-skills-lucasreydman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write-up of disciplined skill-writing practice as test-driven documentation to ensure skills are defined, tested, and reusable before deployment.

Core Features & Use Cases

  • Process-driven skill creation: apply RED-GREEN-REFACTOR to skill drafting to surface and close loopholes.
  • Progressive disclosure patterns: structure SKILL.md for discoverability and minimal upfront loading.
  • Quality assurance mindset: integrate baseline testing, rationalization capture, and meta-testing to ensure reliability across agents.

Quick Start

Draft a new Skill by writing the YAML frontmatter and a focused body, then run RED-GREEN-REFACTOR tests to validate behavior.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I test skill documentation before deployment?▼

Skill documentation is tested by applying the RED-GREEN-REFACTOR workflow to validate frontmatter constraints, progressive disclosure patterns, and discovery-ready metadata before reliable Skill deployment.

What is test-driven documentation for skill creation?▼

Test-driven documentation is a process-driven skill creation method that captures disciplined practices as tested, reusable documentation to surface and close loopholes before deployment.

How do I validate YAML frontmatter for skills?▼

YAML frontmatter is validated by running baseline tests that verify frontmatter constraints, specifically ensuring the required name and description fields are satisfied and properly structured.

Does progressive disclosure affect skill discoverability?▼

Progressive disclosure directly improves skill discoverability by structuring the SKILL.md body to minimize upfront loading, ensuring the skill is metadata-ready and easily surfaced across agents.

What's the best way to write reusable skills across agents?▼

Writing reusable skills across agents requires integrating baseline testing, rationalization capture, and meta-testing into the RED-GREEN-REFACTOR cycle to ensure reliability and close documentation loopholes.

Why does my skill fail frontmatter checks?▼

Skills fail frontmatter checks when the required name and description fields are missing or invalid, which the RED-GREEN-REFACTOR workflow detects during baseline testing before deployment.

Related Skills

Explore More Content & Communication Skills→
shmily1012shmily1012
1

writing-skills

Automate SKILL.md creation and verification with a RED-GREEN-REFACTOR workflow.

Community
Advanced
softmgsoftmg

Skill Builder

Generate Claude Code Skills with standardized YAML frontmatter and progressive disclosure structure.

Official
Advanced
seanGSISGseanGSISG
3

testing-skills-with-subagents

Test skills with subagents to verify resistance to rationalization under pressure.

Community
Basic
devtitusdevtitus

writing-skills

Automate skill documentation creation and validation using the RED-GREEN-REFACTOR workflow.

Community
Intermediate