skills.rest
falconnt
falconntCOMMUNITY
Explore all skills by this author →
Website𝕏@pkeldersGitHub

writing-skills

Create, validate, and refine Windsurf Skills with test-driven RED-GREEN-REFACTOR workflows.

3|Updated Jan 22, 2026
Search Tags:#testing#documentation#writing#validation#frontmatter#skill-creation
One-click install
npx skills add https://github.com/falconnt/windsurf-skills --skill writing-skills-falconnt
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/falconnt/windsurf-skills/tree/main/writing-skills
Command: npx skills add https://github.com/falconnt/windsurf-skills --skill writing-skills-falconnt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured approach to writing, validating, and maintaining Windsurf Skills, ensuring they are testable and deployable.

Core Features & Use Cases

  • Test-driven documentation: Apply a RED-GREEN-REFACTOR workflow to skill content, ensuring quality before deployment.
  • Standardized SKILL.md structure: Enforces YAML frontmatter with name and description and a minimal, reusable body.
  • Deployment readiness: Guides creation, review, and verification steps to minimize risk in production use.

Quick Start

Write a minimal SKILL.md for a new skill and run baseline RED-GREEN-REFACTOR checks to confirm it’s ready for testing.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write and validate Windsurf Skills using a test-driven approach?▼

To write and validate Windsurf Skills, draft a minimal SKILL.md with YAML frontmatter and run baseline RED-GREEN-REFACTOR checks to ensure deployment readiness.

What is the required structure for a SKILL.md file?▼

A SKILL.md file requires YAML frontmatter specifying the name and description, a minimal reusable body, and must follow a strict one-SKILL.md-per-skill structure.

How do I apply RED-GREEN-REFACTOR testing to documentation?▼

RED-GREEN-REFACTOR testing for documentation involves writing skill content, running baseline and stressed condition checks, and refining the text until it passes validation before deployment.

Can I use this test-driven documentation workflow for editing existing skills?▼

Yes, you can apply this test-driven documentation workflow to edit existing skills by running verification checks to confirm they perform under baseline and stressed conditions.

When do I need to use a deployment checklist for skill creation?▼

You need a deployment checklist for skill creation to guide the final review and verification steps, minimizing the risk of errors when deploying Windsurf Skills to production.

Related Skills

Explore More Content & Communication Skills→
GainInsightDevGainInsightDev

af-fix-frontmatter

Fix or create YAML frontmatter metadata in Markdown documentation files.

Official
Basic
mataeilmataeil
5

run-deploy

Trigger GitHub Actions deployments and verify post-deploy health.

Community
Advanced
wzhchinwzhchin
33

skill-writer

Create validated Skill Units with SKILL.md frontmatter and directory structure.

Community
Intermediate
barrydobsonbarrydobson

Testing Skills With Subagents

Test skill documentation with RED-GREEN-REFACTOR cycles and pressure scenarios.

Community
Intermediate