skill-writer

Guide AI agent skill authoring with RED-GREEN-REFACTOR TDD cycles.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/scanady/forge-agents --skill skill-writer-scanady
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/scanady/forge-agents/tree/main/skills/skill-writer
Command: npx skills add https://github.com/scanady/forge-agents --skill skill-writer-scanady

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that your AI agent skills are discoverable, robust, and resistant to rationalization by applying Test-Driven Development (TDD) principles to skill documentation. It guides you through creating and verifying skills that agents will reliably use as intended.

Core Features & Use Cases

  • TDD for Skills: Enforces the RED-GREEN-REFACTOR cycle for skill development.
  • Rationalization Prevention: Provides techniques to counter common AI excuses for not following instructions.
  • Bulletproofing: Guides you to test skills under pressure to ensure compliance.
  • Use Case: When developing a new skill for code review, use this skill to ensure the skill's instructions are clear, concise, and that the agent will actually perform the review correctly even when under time pressure.

Quick Start

Follow the RED-GREEN-REFACTOR cycle to write and test your new skill documentation.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I use TDD to write AI agent skills?

You can use Test-Driven Development (TDD) for AI agent skills by applying the RED-GREEN-REFACTOR cycle to author and verify skill documentation. This methodology ensures your instructions are clear and function reliably as intended before deployment.

What is rationalization prevention in skill documentation?

Rationalization prevention in skill documentation involves applying specific techniques to counter common AI excuses for not following instructions. This ensures your agent resists skipping steps and maintains strict compliance with the provided directives.

How do I make AI skills more discoverable for agents?

To make AI skills discoverable, you must structure the documentation correctly and apply Claude Search Optimization (CSO). This involves meeting specific YAML frontmatter requirements so agents can reliably locate and trigger the skill.

How do I bulletproof skill instructions against pressure?

You can bulletproof skill instructions against pressure by testing the documentation under stress conditions. This verifies that the agent maintains strict compliance and performs the required tasks correctly even when simulating time constraints.

Do I need YAML frontmatter for skill authoring?

Yes, YAML frontmatter is a requirement for skill authoring. Correctly structuring this metadata is necessary for Claude Search Optimization (CSO) and ensures the skill is properly indexed and discoverable by AI agents.