writing-skills

Document skills using a Test-Driven Development RED-GREEN-REFACTOR cycle with the write-skill script.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/Renzo-Tognella/UniversalThingsForMyAgents --skill writing-skills-renzo-tognella
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/Renzo-Tognella/UniversalThingsForMyAgents/tree/main/skills/writing-skills
Command: npx skills add https://github.com/Renzo-Tognella/UniversalThingsForMyAgents --skill writing-skills-renzo-tognella

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps streamline the creation and documentation of skills, applying Test-Driven Development (TDD) principles to process documentation.

Core Features & Use Cases

  • TDD Approach: Follows a RED-GREEN-REFACTOR cycle to ensure skills are clear, actionable, and effective.
  • Skill Creation: Guides through writing test cases, implementing skills, and verifying compliance.
  • Documentation Best Practices: Provides guidelines for concise, well-structured, and discoverable skill documentation.

Quick Start

Run the 'write-skill' script to start creating a new skill. It will guide you through the TDD cycle for skill creation.

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 process documentation?

To apply TDD to process documentation, you follow a RED-GREEN-REFACTOR cycle to write test cases, implement skills, and verify compliance, ensuring instructions remain clear and actionable.

What is the best way to write clear and actionable skill instructions?

The best way to write clear skill instructions is using a TDD-based framework that guides you through writing test cases first, implementing the skill, and verifying documentation compliance and effectiveness.

How do I start creating a new skill using a TDD approach?

To start creating a new skill using a TDD approach, run the 'write-skill' script, which guides you step-by-step through the test-driven RED-GREEN-REFACTOR cycle for skill creation and documentation.

Do I need prior knowledge of TDD to use this skill creation framework?

Yes, you need an understanding of TDD principles and skill documentation practices to effectively use this framework, as it requires writing test cases and verifying compliance throughout the creation cycle.

Why does my skill documentation fail compliance checks?

Skill documentation fails compliance checks when it lacks concise, well-structured, and actionable instructions, which the TDD framework addresses by enforcing test-driven validation and clear writing guidelines.