writing-skills

Create and refine AI documentation using test-driven development cycles.

1|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/xurenlu/marstaff --skill writing-skills-xurenlu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/xurenlu/marstaff/tree/main/skills/writing-skills
Command: npx skills add https://github.com/xurenlu/marstaff --skill writing-skills-xurenlu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a rigorous, test-driven approach to creating and refining documentation (Skills), ensuring they are effective, discoverable, and resistant to common pitfalls.

Core Features & Use Cases

  • Skill Creation Framework: Adapts Test-Driven Development (TDD) principles to documentation.
  • Failure Analysis: Guides you to identify and document how agents fail without the skill (baseline).
  • Refinement & Bulletproofing: Provides methods to close loopholes and prevent rationalizations, ensuring compliance.
  • Use Case: When developing a new Skill for code review, you would first run scenarios to see how agents perform code reviews without the Skill, document their mistakes, then write the Skill to prevent those specific mistakes, and finally test again to ensure it works under pressure.

Quick Start

Use the writing-skills skill to learn how to create a new skill using test-driven development principles.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I use TDD methodology to create AI agent documentation?

To create AI agent documentation using TDD methodology, you adapt the RED-GREEN-REFACTOR cycle to skill authoring by first testing baseline agent failures, writing documentation to prevent those mistakes, then refining for compliance.

What is test-driven development for skill creation?

Test-driven development for skill creation is a framework that applies TDD principles to documentation, requiring you to document how agents fail without a skill first, then writing and refining the skill to prevent those specific failures.

Do I need to understand agent psychology to write effective skills?

Yes, you need to understand agent psychology to write effective skills because this methodology requires identifying and countering agent rationalizations that bypass compliance during testing scenarios.

When should I use a test-driven approach for AI documentation?

You should use a test-driven approach for AI documentation when developing new skills under pressure, ensuring your documentation remains effective, discoverable, and resistant to common agent pitfalls and rationalizations.

How do I document baseline AI failures before writing a skill?

You document baseline AI failures before writing a skill by running scenarios to observe how agents perform tasks without the skill, recording their specific mistakes, and then writing the skill to prevent those exact errors.