writing-skills

Documents and verifies skills using Test-Driven Development principles and SPRING-GREEN-REFRACTOR cycles.

2|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/TheFJK/UberDev --skill writing-skills-thefjk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/TheFJK/UberDev/tree/main/plugins/uberdev/skills/writing-skills
Command: npx skills add https://github.com/TheFJK/UberDev --skill writing-skills-thefjk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps streamline the creation and verification of skills, applying Test-Driven Development principles to documentation, ensuring clear and effective process guidance.

Core Features & Use Cases

  • Skill Creation Process: Facilitates writing, testing, and refining skills using a RED-GREEN-REFACTOR cycle.
  • Testing Framework: Includes pressure scenarios, rationalization tables, and red flags to ensure compliance and effectiveness.
  • Skill Types: Covers techniques, patterns, and references for a variety of use cases.
  • Directory Structure: Defines optimal organization for skills, including SKILL.md, supporting files, and workflow scripts.

Quick Start

Use the writing-skills skill to create a new skill for 'condition-based-waiting'. Start by writing a baseline test that captures the current behavior without the skill, then write the skill itself to address the failures observed.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I apply TDD principles to skill creation and process documentation?

You apply TDD to skill creation by using a RED-GREEN-REFACTOR cycle. This approach enforces discipline by writing baseline tests for process documentation first, then refining the skill to address observed failures and ensure compliance.

What is the best way to verify process documentation and writing guidelines?

The best way to verify process documentation is through a testing framework that includes pressure scenarios, rationalization tables, and red flags. This ensures your writing guidelines maintain compliance and effectiveness across various skill types.

How do I structure directories for skill creation using TDD?

You structure skill directories by organizing files into SKILL.md, supporting references, and workflow scripts. This optimal layout facilitates the TDD cycle, allowing you to systematically test and refine techniques, patterns, and references.

Do I need to understand TDD principles before documenting techniques and patterns?

Yes, you need a solid understanding of TDD principles before documenting techniques and patterns. This Skill requires applying test-driven discipline to enforce compliance, demonstrate techniques, and verify references effectively during the creation process.

Can I use a baseline test to capture current behavior before writing a new skill?

Yes, you can write a baseline test to capture current behavior without the skill. This TDD approach allows you to observe failures first, then write the skill itself to address those specific gaps in process documentation.

What types of skills can I create and verify using a test-driven documentation approach?

You can create and verify techniques, patterns, and references using a test-driven documentation approach. This variety covers multiple use cases, applying discipline enforcement and pattern application to ensure effective process guidance.