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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the common issue of untested, ineffective process documentation that fails to guide AI agent behavior under pressure, leading to repeated mistakes, non-compliance with critical workflows, and wasted time debugging broken skills after deployment.

Core Features & Use Cases

  • TDD-Adapted Skill Creation: Follow the RED-GREEN-REFACTOR cycle to build skills that work in real-world pressure scenarios, not just in theory.
  • Rationalization Bulletproofing: Add explicit counters, red flag lists, and foundational principles to prevent agents from bypassing discipline-enforcing skills like TDD or verification requirements.
  • Claude Search Optimization: Structure skill names, descriptions, and content to ensure future Claude instances can discover and correctly apply your skills when needed.
  • Use Case: Use this when creating new team workflow skills, editing existing skills to close gaps found during usage, or verifying skills will be followed by agents before sharing them with your team.

Quick Start

Use the writing-skills skill to create a new tested skill for our team's pre-commit code review workflow, following the TDD cycle to verify it works under time pressure before we deploy it to the team.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I create Claude Code skills that agents actually follow during workflow execution?

To create Claude Code skills that agents follow, use test-driven documentation to build discipline-enforcing rules and technique guides. This approach applies the RED-GREEN-REFACTOR cycle to verify skills work under real-world pressure before deployment.

Why does my AI agent bypass process documentation and rationalize skipping steps?

AI agents bypass process documentation when it lacks rationalization bulletproofing. You can prevent this by adding explicit counters, red flag lists, and foundational principles to your skills, ensuring consistent agent compliance with defined workflows and standards.

What is test-driven development for AI agent skill creation?

Test-driven development for AI agent skill creation is adapting the RED-GREEN-REFACTOR cycle to process documentation. It validates that skills guide AI behavior correctly under pressure, eliminating untested documentation that fails during workflow execution.

How do I optimize skills for Claude Search discovery?

To optimize skills for Claude Search discovery, structure skill names, descriptions, and content so future Claude instances can discover and correctly apply them. This ensures your team workflow skills are retrieved when needed.

Can I use this approach to edit and validate existing team workflow skills?

Yes, you can use test-driven documentation to edit existing skills and close gaps found during usage. It validates whether agents will follow skills before sharing them with your team, covering creation, editing, and validation workflows.

What are the limitations of untested process documentation for AI agents?

Untested process documentation leads to repeated mistakes, non-compliance with critical workflows, and wasted time debugging broken skills after deployment. It fails to guide AI agent behavior effectively under pressure during execution.