writing-skills

Create and verify SKILL.md files using test-driven development principles.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/fauzanazz/claude-skills --skill writing-skills-fauzanazz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/fauzanazz/claude-skills/tree/main/writing-skills
Command: npx skills add https://github.com/fauzanazz/claude-skills --skill writing-skills-fauzanazz

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the creation and verification of AI documentation through a test-driven development (TDD) approach, ensuring clarity and effectiveness.

Core Features & Use Cases

  • Skill Creation: Develop new skills by writing test cases, observing failures, and then creating the skill document.
  • Skill Verification: Validate the skill's functionality and correctness before deployment.
  • Use Case: When you need to document a new process or technique, use this skill to write the skill document, test it, and refine it iteratively.

Quick Start

Run the writing-skills skill to start the TDD process for creating a new skill. Provide the initial pressure scenarios to watch the skill fail, then write the skill document and test it until it passes.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I create AI documentation using test-driven development?

To create AI documentation using TDD, you write initial test cases for the expected functionality, observe the failures, and then write the skill document until it passes. This iterative process ensures clarity and effectiveness before deployment.

What is the best way to verify skill functionality before deployment?

The best way to verify skill functionality is to apply test-driven development principles by defining pressure scenarios, running the skill to observe failures, and refining the documentation iteratively until all compliance and functional tests pass.

Do I need to understand TDD to use this skill creation approach?

Yes, you need a solid understanding of test-driven development and documentation best practices. The approach requires you to write test cases first and use those failures to guide the creation and refinement of the SKILL.md document.

How does test-driven documentation improve the skill creation process?

Test-driven documentation improves skill creation by streamlining the verification process. Writing tests first exposes flaws early, ensuring the final skill document achieves established standards and functional correctness through iterative refinement.

Can I validate a SKILL.md file against established standards without writing code?

Validating a SKILL.md file requires providing initial pressure scenarios to test the skill's functionality. You observe the failures and iteratively refine the document, ensuring it complies with established standards before deployment.

When should I not use a TDD approach for writing skills?

You should avoid using TDD for writing skills if you lack understanding of test-driven development principles or documentation best practices, as the process relies heavily on writing effective test cases to guide document creation.