writing-skills

Apply TDD principles to skill development with baseline tests and iterative refinement.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of creating reliable, disciplined documentation by applying test-driven development principles to skill creation, preventing unverified or loophole-prone skills from being deployed.

Core Features & Use Cases

  • Baseline Testing: Run pressure scenarios without the skill to detect natural violations agents perform.
  • Skill Implementation: Write minimal, targeted instructions to address specific violations identified.
  • Closed-loop Refinement: Iteratively eliminate rationalizations and loopholes by adding explicit negations and foundational principles.
  • Validation Cycles: Re-test under maximum pressure to verify compliance; re-fine until bulletproof.
  • Use Case: Developing a TDD discipline skill that enforces never writing code before tests, verified by simulated agent behavior under pressure.

Quick Start

Before deploying, run scenarios without the skill to observe violations, then write minimal instructions to prevent those violations, followed by re-validation under complex pressures.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I apply test-driven development to skill creation for agents?

Test-driven development for skill creation involves running baseline pressure scenarios without the skill to detect natural violations, then writing minimal instructions to address those specific violations. This closed-loop refinement iteratively closes loopholes until bulletproof compliance is achieved.

Why does my AI agent bypass instructions and generate rationalizations under pressure?

Agents generate rationalizations when instructions contain loopholes. Closed-loop refinement eliminates this by adding explicit negations and foundational principles, then re-testing under maximum pressure to verify compliance and prevent rationalizations.

What is the best way to ensure bulletproof agent compliance for custom skills?

The best way to ensure bulletproof agent compliance is through validation cycles that re-test the skill under complex pressures. You iteratively refine instructions by adding explicit negations until all loopholes are eliminated.

How do I identify and close loopholes in AI agent instructions?

You identify loopholes by running baseline tests without the skill to observe natural violations. Close them by writing minimal targeted instructions, validating under pressure, and re-financing until the agent complies without rationalizations.

Do I need to run validation cycles every time I modify skill instructions?

Yes, running validation cycles after modifying instructions is required. Re-testing under maximum pressure verifies that new changes do not introduce loopholes and ensures the skill maintains bulletproof agent compliance.