writing-skills

Create and test agent skills using test-driven development methodology.

Updated May 16, 2026
One-click install
npx skills add https://github.com/michalo1334/ScenarioImpactDSL --skill writing-skills-michalo1334
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/michalo1334/ScenarioImpactDSL/tree/main/.opencode/skills/writing-skills
Command: npx skills add https://github.com/michalo1334/ScenarioImpactDSL --skill writing-skills-michalo1334

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing effective agent skills without verification leads to documentation that agents ignore or misinterpret under pressure. This Skill applies test-driven development to skill authoring, ensuring skills actually change agent behavior before deployment. ## Core Features & Use Cases - TDD-Based Skill Authoring: Follows the RED-GREEN-REFACTOR cycle where baseline pressure scenarios are run without the skill first, then the skill is written to address observed failures, then loopholes are closed iteratively. - Subagent Pressure Testing: Provides a methodology for testing skills with realistic scenarios combining time pressure, sunk cost, authority, and exhaustion to verify compliance. - Discovery Optimization: Covers Claude Search Optimization techniques including description writing, keyword coverage, naming conventions, and token efficiency. - Use Case: When creating a new discipline-enforcing skill like a TDD requirement, run baseline scenarios with subagents to capture their rationalizations verbatim, write the skill addressing those specific excuses, then refactor until agents comply under maximum pressure. ## Quick Start Ask the agent to create a new skill for a specific technique using the writing-skills methodology, starting with baseline pressure scenario testing before writing any documentation.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I test an agent skill before deploying it?▼

Run pressure scenarios with subagents without the skill first to capture baseline failures and rationalizations verbatim. Then write the skill addressing those specific failures, re-test with the skill present, and iterate to close any new loopholes agents discover.

What makes a good skill description for discovery?▼

Start with "Use when..." and describe only triggering conditions, symptoms, and situations in third person. Never summarize the skill's workflow in the description, because agents may follow the description shortcut instead of reading the full skill content.

What is the structure of a valid SKILL.md file?▼

A SKILL.md requires YAML frontmatter with name and description fields, followed by a markdown body containing an overview, when-to-use guidance, core patterns, quick reference, and common mistakes sections. Keep the body under 500 lines and move heavy reference material to separate files.

When should I not create a new skill?▼

Skip skill creation for one-off solutions, standard practices already well-documented elsewhere, project-specific conventions that belong in project config files, and mechanical constraints that can be enforced with automated validation instead of documentation.

Why do agents ignore skills under time pressure?▼

Agents rationalize skipping discipline-enforcing skills when facing combined pressures like deadlines, sunk cost, and exhaustion. Counter this with explicit negations of specific excuses, rationalization tables, red flag lists, and foundational principles like "violating the letter is violating the spirit."