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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing documentation-style skills for AI agents often produces untested, unreliable instructions that agents ignore or misinterpret under pressure. This Skill applies test-driven development (RED-GREEN-REFACTOR) to skill authoring so every skill is verified against real agent behavior before deployment. ## Core Features & Use Cases - TDD-based skill authoring: Run baseline pressure scenarios with subagents, document failures, write the skill, then verify compliance. - Discovery optimization (CSO): Guidelines for writing name and description frontmatter, keyword coverage, and token-efficient structure so agents actually find the skill. - Rationalization bulletproofing: Techniques like rationalization tables, red-flag lists, and explicit loophole closing for discipline-enforcing skills. - Use Case: You want to create a new skill enforcing a code-review workflow. Use this Skill to first run a baseline scenario without the skill, capture the agent's excuses verbatim, then write and iteratively harden the skill until agents comply under pressure. ## Quick Start Ask the agent to help you create a new skill using the writing-skills TDD process, starting with a baseline pressure scenario.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write a SKILL.md file for an AI agent?▼

A SKILL.md needs YAML frontmatter with only name and description fields, followed by a Markdown body with an overview, when-to-use triggers, core patterns, and a quick reference. The description should start with "Use when..." and describe triggering conditions only, never the workflow.

How to test an agent skill before deploying it?▼

Test skills by running pressure scenarios with subagents: first without the skill to capture baseline failures and rationalizations, then with the skill to verify compliance. Iterate by closing loopholes agents discover until the skill holds under combined pressures like time and sunk cost.

What should go in a skill description field?▼

The description should only state when to use the skill, starting with "Use when..." plus concrete symptoms and situations. Never summarize the skill's process, because agents may follow the description shortcut instead of reading the full skill body.

When should I not create a new skill?▼

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

Why do agents ignore or bypass skill instructions?▼

Agents rationalize around rules under pressure from time constraints, sunk cost, or authority claims. Counter this with explicit loophole closing, rationalization tables built from baseline testing, and red-flag checklists that make violations easy to self-detect.