writing-skills

Apply RED-GREEN-REFACTOR cycles to author and validate documentation skills.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/nuts-and-bolts-ai/nanoclaw-cheerful --skill writing-skills-nuts-and-bolts-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/nuts-and-bolts-ai/nanoclaw-cheerful/tree/main/groups/slack_cheerful-dev/.claude/skills/writing-skills
Command: npx skills add https://github.com/nuts-and-bolts-ai/nanoclaw-cheerful --skill writing-skills-nuts-and-bolts-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that new and updated documentation skills are robust, discoverable, and effective by applying Test-Driven Development (TDD) principles to the skill creation process, preventing common pitfalls and rationalizations.

Core Features & Use Cases

  • TDD for Skills: Adapts the RED-GREEN-REFACTOR cycle for writing and testing documentation skills.
  • Pressure Scenario Testing: Provides methods to test skills under realistic constraints (time, sunk cost, authority) to uncover rationalizations.
  • Rationalization Countermeasures: Offers techniques to close loopholes and prevent agents from bypassing skill requirements.
  • Use Case: When developing a new skill for enforcing code review policies, you would use this skill to write test scenarios that simulate pressure (e.g., urgent deadline) to ensure the new skill is followed even when an agent is tempted to skip it.

Quick Start

Use the writing-skills skill to create a new skill by following the TDD cycle, starting with writing a failing test scenario.

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 write and test agent documentation skills?

You use TDD for skill development by adapting the RED-GREEN-REFACTOR cycle to author and validate documentation skills, starting with a failing test scenario before writing the skill logic.

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

The best way to prevent rationalization is to apply countermeasures that close loopholes, testing skills under realistic constraints like sunk cost and authority to ensure agents do not bypass requirements.

How do I pressure test agent behavior under realistic constraints?

You pressure test agent behavior by simulating realistic constraints such as time pressure, sunk cost, and authority, which uncovers rationalizations and ensures the skill remains robust under stress.

Can I apply TDD principles to enforce code review policies for agents?

Yes, you can apply TDD principles to enforce code review policies by writing test scenarios that simulate pressure, like an urgent deadline, to ensure agents follow the new skill even when tempted to skip it.

Why does my agent skip documentation requirements under deadline pressure?

Agents skip documentation requirements under deadline pressure due to rationalizations; this skill addresses this by defining pressure testing methodologies and countermeasures to enforce compliance.

Do I need any dependencies to start creating skills with TDD?

No dependencies are required to start creating skills with TDD; you only need to follow the RED-GREEN-REFACTOR cycle and define test scenarios to validate agent behavior and documentation compliance.