One-click install
npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill writing-skills-viniciuscs84
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/viniciuscs84/sdd-toolkit/tree/main/skills/writing-skills
Command: npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill writing-skills-viniciuscs84

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Untested skill documentation often fails in practice because agents rationalize around rules under time, sunk-cost, or authority pressure, and authors cannot know whether a skill teaches the right behavior without observing baseline failures first. ## Core Features & Use Cases - TDD-based skill authoring: Applies the RED-GREEN-REFACTOR cycle to documentation by running baseline pressure scenarios with subagents, writing the skill to address observed failures, and closing loopholes iteratively. - Discovery optimization guidance: Provides rules for frontmatter descriptions, keyword coverage, naming conventions, and token efficiency so agents can find and load the right skill. - Testing methodology references: Includes detailed guidance on pressure scenario design, rationalization tables, persuasion principles, and Anthropic's official authoring best practices. - Use Case: Before deploying a new discipline-enforcing skill like a TDD rule, run combined-pressure scenarios (time + sunk cost + exhaustion) against subagents without the skill, capture their verbatim rationalizations, then write and refactor the skill until agents comply under maximum pressure. ## Quick Start Ask the agent to create a new skill for a recurring technique, first running baseline pressure scenarios with subagents and then writing the SKILL.md following the RED-GREEN-REFACTOR checklist.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I test a new agent skill before deploying it?

Run pressure scenarios with subagents without the skill first to document baseline failures verbatim, then write the skill addressing those specific rationalizations and re-test until agents comply. Combine three or more pressures like time, sunk cost, and exhaustion for realistic results.

What should a SKILL.md description field contain?

The description should start with "Use when..." and list only triggering conditions, symptoms, and contexts in third person. Never summarize the skill's workflow, because agents may follow the description shortcut instead of reading the full skill body.

How do I write pressure scenarios for testing skills?

Create realistic scenarios with concrete A/B/C options, real constraints like deadlines and deploy windows, and multiple combined pressures such as time, sunk cost, authority, and exhaustion. Force the agent to make an actual decision rather than answer academically.

When should I not create a skill?

Skip skill creation for one-off solutions, practices already well-documented elsewhere, project-specific conventions that belong in CLAUDE.md, and mechanical constraints that can be enforced with regex or validation scripts instead of documentation.

Why do agents ignore skills under pressure?

Agents rationalize around rules using excuses like sunk cost, pragmatism, or spirit-versus-letter arguments. Counter this by closing loopholes explicitly, building rationalization tables, adding red flag lists, and stating that violating the letter violates the spirit.