writing-skills

Apply test-driven development principles to create and verify agent skills.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of creating inconsistent, untested, or ineffective skills that fail to guide agent behavior correctly, by applying test-driven development principles to process documentation to ensure skills are bulletproof and function as intended when deployed.

Core Features & Use Cases

  • TDD-Adapted Skill Creation Workflow: Maps the RED-GREEN-REFACTOR cycle to skill development, requiring baseline testing of agent behavior before writing skill content to ensure the skill addresses actual agent failures.
  • Skill Structure & Discovery Optimization: Provides guidelines for compliant SKILL.md frontmatter, Claude Search Optimization (CSO) to ensure skills are discoverable by future agents, and appropriate file organization for different skill types (technique, pattern, reference).
  • Bulletproofing for Discipline Skills: Includes patterns to close agent rationalization loopholes, build rationalization tables, and create red flag lists for skills that enforce strict workflows like TDD or code review requirements.
  • Use Case: Use this Skill when you are creating a new reusable skill for your team's workflows, editing an existing skill that agents are not following correctly, or verifying a skill works as intended before sharing it with your team.

Quick Start

Use the writing-skills skill to create a new tested skill for your team's standard code review workflow.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I create Claude Code skills that agents actually follow?

To create Claude Code skills that agents follow, apply test-driven development principles to process documentation by mapping the RED-GREEN-REFACTOR cycle to skill development, which requires baseline testing of agent behavior before writing skill content.

Why does my agent ignore or rationalize past workflow requirements in skill documentation?

Agents ignore workflow requirements when skills lack rationalization loopholes. You can build rationalization tables and red flag lists to close these loopholes and strictly enforce workflows like TDD or code review requirements.

What is the best way to structure SKILL.md files for Claude Search Optimization?

The best way to structure SKILL.md files for Claude Search Optimization is to use compliant frontmatter and appropriate file organization for different skill types, ensuring skills are discoverable by future agents across compatible systems.

How do I test agent behavior before writing new process documentation?

You test agent behavior before writing process documentation by establishing a baseline of current agent failures, which is the RED phase of the TDD-adapted workflow, ensuring the new skill directly addresses actual agent shortcomings.

Can I use this TDD approach for editing existing skills that are failing?

Yes, you can use this TDD approach for editing existing skills. It allows you to verify skill effectiveness and identify why agents are not following the current documentation correctly before deploying updates.

When should I not use TDD for skill authoring?

You should not use TDD for skill authoring when creating purely informational reference documents that do not require enforcing strict agent workflows, as the RED-GREEN-REFACTOR cycle is designed for guiding active process behavior.