skills.rest
nassimbf
nassimbfCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Apply RED-GREEN-REFACTOR cycles to create and test SKILL.md documentation.

3|Updated Apr 18, 2026
Search Tags:#testing#tdd#documentation#writing#deployment#skill
One-click install
npx skills add https://github.com/nassimbf/ftitos-claude-code --skill writing-skills-nassimbf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/nassimbf/ftitos-claude-code/tree/main/skills/writing-skills
Command: npx skills add https://github.com/nassimbf/ftitos-claude-code --skill writing-skills-nassimbf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing Skills apply test-driven development to process documentation, ensuring skills are created, tested, and iterated before deployment to prevent drift, rationalizations, and misalignment with real usage.

Core Features & Use Cases

  • Enforces the RED-GREEN-REFACTOR cycle for skill creation and maintenance.
  • Captures exact baseline failures with rationalization tracking to prevent common shortcuts.
  • Provides deployment-ready SKILL.md structure and a scalable testing methodology to ensure reliability.

Quick Start

Follow the RED-GREEN-REFACTOR workflow to write a new skill, run baseline tests, implement, and re-test until all scenarios pass.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I apply test-driven development to documentation?▼

Test-driven development for documentation involves applying RED-GREEN-REFACTOR cycles to skill creation, capturing baseline failures, and refactoring until all scenarios pass before deployment.

What is the best way to prevent rationalizations and drift in skill documentation?▼

Preventing rationalizations and drift requires tracking exact baseline failures during the RED phase and validating corrections through structured deployment checklists before finalizing the SKILL.md file.

How do I structure a SKILL.md file for test-driven deployment?▼

Structuring a SKILL.md file for test-driven deployment requires YAML frontmatter with name and description, a structured deployment checklist, rationalization tracking, red-flag lists, and a clear discovery description for Claude.

Can I use TDD cycles to edit and refactor existing skills?▼

Yes, you can use TDD cycles to edit existing skills by running baseline tests on current behavior, implementing changes, and re-testing until all scenarios pass to ensure reliability without regressions.

When should I not use a test-driven approach for writing skills?▼

A test-driven approach for writing skills is not suitable for rapid prototyping or exploratory drafting where behavior is not yet defined, as it requires exact baseline failures and structured deployment checklists before implementation.

Related Skills

Explore More Content & Communication Skills→
ayourtchayourtch

writing-skills

Automate test-driven documentation generation for SKILL.md files.

Community
Basic
liamtran96liamtran96

testing-skills-with-subagents

Validate skill documentation with RED-GREEN-REFACTOR testing cycles.

Community
Basic
kslhunterkslhunter
2

sd-skill

Enforce a RED-GREEN-REFACTOR workflow for skill documentation and testing.

Community
Advanced
wangx7wangx7

writing-skills

Create, edit, and verify AI skills using test-driven development cycles.

Community
Advanced