skills.rest
ImL1s
ImL1sCOMMUNITY
Explore all skills by this author →
Website𝕏@l1s_aiGitHub

writing-skills

Document and validate Claude Skills using the RED-GREEN-REFACTOR cycle.

6|Updated Apr 23, 2026
Search Tags:#documentation#writing#skills#subagents#red-green-refactor#test-driven-development#skill-authoring
One-click install
npx skills add https://github.com/ImL1s/flutter-claude-skills --skill writing-skills-iml1s
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/ImL1s/flutter-claude-skills/tree/main/skills/writing-skills
Command: npx skills add https://github.com/ImL1s/flutter-claude-skills --skill writing-skills-iml1s

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing skills is the application of Test-Driven Development to process documentation. It ensures skill documentation is created, tested, and verified before deployment by simulating real-world baselines with subagents and iterating until it is bulletproof against rationalizations.

Core Features & Use Cases

  • TDD-based skill documentation process: RED-GREEN-REFACTOR lifecycle for writing SKILL.md and related materials.
  • Subagent-based testing: exposes baseline failures and rationalizations to drive focused improvements.
  • Applicable to creating new skills, editing existing ones, and validating deployment readiness in production-like scenarios.

Quick Start

Follow the RED-GREEN-REFACTOR cycle to draft and test a Skill before deployment.

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 to write and validate skill documentation?▼

Test-Driven Development for skill documentation applies the RED-GREEN-REFACTOR lifecycle to draft SKILL.md files, exposing baseline failures via subagents and iterating until the documentation is bulletproof against rationalizations.

What is subagent-based testing for skill authoring and how does it work?▼

Subagent-based testing simulates real-world scenarios to expose baseline failures and rationalizations in skill documentation, driving focused improvements through iterative testing cycles before deployment.

How do I structure a SKILL.md file for deployment readiness?▼

A deployment-ready SKILL.md requires YAML frontmatter with name and description fields, a concise skill structure, optional scripts, references, assets, and a tested deployment checklist validated through the RED-GREEN-REFACTOR cycle.

Can I apply TDD documentation workflows to edit existing skills?▼

Yes, the TDD documentation workflow applies when creating new skills, editing existing ones, or verifying changes across the documentation workflow with subagents and pressure scenarios.

What's the best way to verify skill documentation against rationalizations before deployment?▼

Verify skill documentation by running subagent-based pressure scenarios that expose rationalizations, then iterate through the RED-GREEN-REFACTOR cycle until the documentation passes all baseline tests.

Do I need YAML frontmatter to test skill documentation with subagents?▼

Yes, YAML frontmatter with name and description fields is required in SKILL.md files to validate and test documentation using the TDD-driven RED-GREEN-REFACTOR lifecycle with subagents.

Related Skills

Explore More Software Engineering Skills→
rkz91rkz91
264

create-skill

Create and validate Cursor Skills with SKILL.md frontmatter and documentation templates.

Community
Intermediate
KhoiwallKhoiwall

writing-skills

Enforce RED-GREEN-REFACTOR cycles for test-driven skill documentation workflows.

Community
Advanced
franroafranroa

testing-skills-with-subagents

Test skills with subagents using RED-GREEN-REFACTOR cycles and scenario templates.

Community
Intermediate
russosalvrussosalv
5

writing-skills

Apply TDD with RED-GREEN-REFACTOR cycles to author and verify agent skills.

Community
Advanced