skills.rest
futuregerald
futuregeraldCOMMUNITY
Explore all skills by this author →
𝕏@futuregeraldGitHub

writing-skills

Enforces a RED-GREEN-REFACTOR workflow for creating and testing SKILL.md-based documentation.

6|Updated Feb 4, 2026
Search Tags:#workflow#testing#tdd#documentation#rationalization#skill-writing
One-click install
npx skills add https://github.com/futuregerald/futuregerald-claude-plugin --skill writing-skills-futuregerald
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/futuregerald/futuregerald-claude-plugin/tree/main/skills/writing-skills
Command: npx skills add https://github.com/futuregerald/futuregerald-claude-plugin --skill writing-skills-futuregerald

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing and maintaining Skills requires discipline and a test-driven approach; this guide codifies the RED-GREEN-REFACTOR workflow for skill creation and verification.

Core Features & Use Cases

  • TDD-based Skill Creation: Define pressure scenarios and verify agent behavior under baseline and guided conditions.
  • Rationalization Tracking: Document rationalizations verbatim and map them to concrete counters.
  • Progressive Disclosure: Organize SKILL.md with frontmatter, core sections, and optional links to heavy references.

Quick Start

Draft a SKILL.md for a sample topic and run baseline RED-GREEN-REFACTOR tests to verify behavior.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I use test-driven development for writing skills?▼

Test-driven development for writing skills involves applying a RED-GREEN-REFACTOR workflow to skill creation. You define baseline pressure scenarios, verify agent behavior, and refactor documentation to close loopholes.

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

The RED-GREEN-REFACTOR workflow for skill documentation is a test-driven approach enforcing baseline RED testing, green skill development, and refactoring to close loopholes. It ensures disciplined, reliable guides.

How do I track rationalizations during skill creation?▼

Track rationalizations during skill creation by documenting them verbatim and mapping them to concrete counters. This process is part of the test-driven skill writing workflow to ensure reliability.

How should I structure a SKILL.md file for progressive disclosure?▼

Structure a SKILL.md file for progressive disclosure by organizing frontmatter, core sections, and optional links to heavy references. This ensures tested, reliable guides through disciplined documentation.

Why do my AI skills fail under baseline pressure scenarios?▼

AI skills fail under baseline pressure scenarios due to undocumented rationalizations and loopholes. Applying a RED-GREEN-REFACTOR testing workflow captures these failures and enforces disciplined skill development.

Related Skills

Explore More Content & Communication Skills→
darthlinuxerdarthlinuxer
1

writing-skills

Enforce TDD-driven authoring with SKILL.md frontmatter validation and structured metadata.

Community
Advanced
seanGSISGseanGSISG
3

testing-skills-with-subagents

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

Community
Basic
RBozydarRBozydar

skill-creator

Generate Claude Skill skeletons and validate SKILL.md structure.

Community
Advanced
MarbleSodasMarbleSodas

test-driven-development

Enforce RED-GREEN-REFACTOR workflows with failing tests and minimal code changes.

Community
Advanced