writing-skills

Apply test-driven development cycles to author and maintain agent skill documentation.

110|4|Updated Jul 19, 2016
One-click install
npx skills add https://github.com/deathbeam/dotfiles --skill writing-skills-deathbeam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/deathbeam/dotfiles/tree/main/agents/.agents/skills/writing-skills
Command: npx skills add https://github.com/deathbeam/dotfiles --skill writing-skills-deathbeam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the problem of inconsistent or ineffective agent documentation by applying Test-Driven Development (TDD) principles to the creation and maintenance of process guides.

Core Features & Use Cases

  • TDD for Documentation: Provides a structured RED-GREEN-REFACTOR cycle to ensure skills are tested before deployment.
  • Rationalization Prevention: Includes techniques to identify and block agent loopholes and excuses during task execution.
  • Use Case: Use this when you need to create a new skill or update an existing one to ensure it is robust, verifiable, and resistant to agent rationalization under pressure.

Quick Start

Use the writing-skills framework to create a new skill by first defining a failing pressure scenario and then documenting the required behavior.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I use test-driven development to write agent skill documentation?

Test-driven development for agent skill documentation applies a structured RED-GREEN-REFACTOR cycle to author and maintain process guides. You first define a failing pressure scenario, document the required behavior, and iterate to close loopholes.

How do I prevent rationalization and loopholes in agent process guides?

To prevent rationalization in agent process guides, implement baseline failure testing and explicit rationalization counters during skill creation. This technique blocks agent excuses and enforces discipline under pressure by iteratively closing identified loopholes.

What is the best way to test agent documentation before deployment?

The best way to test agent documentation before deployment is defining a failing pressure scenario first. This test-driven approach verifies that process guides are robust, compliant, and resistant to agent rationalization under pressure before actual use.

When do I need test-driven development for process documentation?

You need test-driven development for process documentation when creating discipline-enforcing, technique, or pattern-based skills that require high reliability under pressure. It ensures compliance and robustness through baseline failure testing and iterative loophole closure.

Does test-driven documentation work for refactoring existing skills?

Yes, test-driven documentation works for refactoring existing skills. By applying the RED-GREEN-REFACTOR cycle, you can update process guides, verify compliance through baseline failure testing, and explicitly close any new agent loopholes introduced during updates.