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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing effective agent skills without testing leads to documentation that agents ignore, misinterpret, or rationalize away under pressure, resulting in unreliable behavior. ## Core Features & Use Cases - TDD-Based Skill Authoring: Applies the RED-GREEN-REFACTOR cycle to documentation by running baseline pressure scenarios with subagents before writing any skill content. - Skill Discovery Optimization: Provides rules for writing descriptions, naming conventions, keyword coverage, and token efficiency so agents can find and load skills correctly. - Rationalization Bulletproofing: Includes techniques like rationalization tables, red flag lists, and persuasion principles to close loopholes agents exploit under time or sunk-cost pressure. - Use Case: When creating a new discipline-enforcing skill like a TDD requirement, run pressure scenarios with subagents first, document their verbatim excuses, then write the skill to counter those specific rationalizations. ## Quick Start Ask the agent to create a new skill following the test-driven development process, starting with baseline pressure scenarios 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 write an effective SKILL.md file for AI agents?

Start with YAML frontmatter containing a name and a description that begins with "Use when" and lists triggering conditions only. Keep the body concise with an overview, quick reference, and examples, and test the skill with subagent pressure scenarios before deploying.

How do I test an agent skill before deployment?

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

What should go in a skill description field?

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

Why do agents ignore or bypass skill instructions?

Agents rationalize around rules under pressures like time constraints, sunk cost, and authority. Counter this with explicit negations of known excuses, rationalization tables, red flag lists, and foundational principles like "violating the letter is violating the spirit."

When should I not create a new skill?

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