writing-skills

Guide AI Skill creation and refinement using a Test-Driven Development methodology.

1|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/dwalleck/kiro-starter-kit --skill writing-skills-dwalleck
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/dwalleck/kiro-starter-kit/tree/main/.kiro/skills/writing-skills
Command: npx skills add https://github.com/dwalleck/kiro-starter-kit --skill writing-skills-dwalleck

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a rigorous, test-driven framework for creating and refining AI Skills, ensuring they are discoverable, effective, and robust against rationalization, thereby improving AI agent performance and reliability.

Core Features & Use Cases

  • TDD for Skills: Adapts the RED-GREEN-REFACTOR cycle to skill authoring.
  • Rationalization Countermeasures: Provides techniques to prevent AI agents from bypassing skill rules under pressure.
  • Use Case: When developing a new skill for code review, you would first write test scenarios to see how an AI agent fails to perform a code review without the skill (RED), then write the skill to address those specific failures (GREEN), and finally, test against pressures like tight deadlines or complex code to ensure the AI still follows the skill (REFACTOR).

Quick Start

Use the writing-skills skill to create a new skill document following TDD principles.

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 create robust AI agent skills?

TDD for AI skills involves writing test scenarios to observe agent failures without the skill (RED), authoring the skill to address those failures (GREEN), and refactoring to ensure compliance under pressure. This methodology ensures skills are discoverable and robust against rationalization.

What is AI agent rationalization in skill creation?

AI agent rationalization occurs when agents bypass or ignore skill rules under pressure, such as tight deadlines or complex inputs. TDD for skills addresses this by testing against these specific pressures during the refactor phase to close loopholes and enforce compliance.

How do I test AI agent behavior under pressure before writing a skill?

You test AI agent behavior under pressure by creating scenarios where the agent must perform a task without the skill, simulating constraints like tight deadlines or complex code. Observing these failures establishes the RED phase for test-driven skill creation.

What is the best way to prevent AI agents from bypassing skill rules?

The best way to prevent AI agents from bypassing skill rules is to implement rationalization countermeasures through a TDD cycle. You test the agent against edge cases and pressures, then refactor the skill document to close loopholes and ensure strict compliance.

Can I apply the RED-GREEN-REFACTOR cycle to AI documentation and skill authoring?

Yes, you can apply the RED-GREEN-REFACTOR cycle to AI documentation and skill authoring. The cycle is adapted to first test unwritten agent behavior, then write the skill to fix failures, and finally refactor to ensure the agent follows the skill under pressure.

When do I need a test-driven approach for refining AI skills?

You need a test-driven approach for refining AI skills when you must ensure they remain effective and compliant under complex conditions. It is essential for closing loopholes that allow agents to rationalize bypassing rules when facing tight deadlines or difficult tasks.