writing-skills

Create, edit, and verify AI skills using a TDD red-green-refactor cycle.

4|3|Updated Jul 14, 2025
One-click install
npx skills add https://github.com/luan/dot-claude --skill writing-skills-luan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/luan/dot-claude/tree/main/skills/writing-skills
Command: npx skills add https://github.com/luan/dot-claude --skill writing-skills-luan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the creation, editing, and verification of AI skills, ensuring they are robust, efficient, and adhere to best practices through a Test-Driven Development (TDD) approach.

Core Features & Use Cases

  • Skill Creation & Editing: Guides users through the process of writing new skills or modifying existing ones.
  • TDD Enforcement: Mandates that skills are developed with failing tests first, promoting reliability.
  • Verification: Ensures skills function correctly under pressure scenarios before deployment.
  • Use Case: When developing a new AI skill for summarizing meeting transcripts, use this skill to write a failing test case for a complex, jargon-filled transcript, then build the skill to pass the test, and finally refactor for clarity and efficiency.

Quick Start

Use the writing-skills skill to create a new skill for summarizing technical documentation.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I use TDD to build AI skills?

To build AI skills with TDD, you write failing tests first, then develop the skill to pass them, and finally refactor for clarity and token efficiency. This enforces a strict red-green-refactor cycle during skill creation.

What is the best way to verify AI skills before deployment?

The best way to verify AI skills is by running them against pressure scenarios using Test-Driven Development. This methodology ensures the skill functions correctly and handles edge cases reliably before deployment.

How do I validate frontmatter and documentation in SKILL.md files?

You validate frontmatter and documentation in SKILL.md files by applying skill verification standards. This process enforces documentation adherence, frontmatter validation, and progressive disclosure of information for token efficiency.

Can I refactor AI skills for token efficiency without losing functionality?

Yes, you can refactor AI skills for token efficiency without losing functionality by applying the refactor phase of TDD. This step ensures the skill maintains robust performance while strictly adhering to documentation standards.

Does writing-skills support categorizing new AI skills?

Yes, the skill creation process explicitly supports skill categorization. It guides you through writing new skills while ensuring proper frontmatter validation and progressive disclosure within your SKILL.md files.

Why should I use a red-green-refactor cycle for skill development?

Using a red-green-refactor cycle for skill development ensures reliability by mandating that skills are developed with failing tests first. This enforces robust verification and progressive documentation before deployment.