skills.rest
circld
circldCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Apply test-driven development cycles to create and verify AI skill documentation.

1|Updated May 25, 2025
Search Tags:#skill development#tdd#documentation#rationalization#process improvement#agent testing
One-click install
npx skills add https://github.com/circld/dotfiles --skill writing-skills-circld
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/circld/dotfiles/tree/main/external/opencode/skills/writing-skills
Command: npx skills add https://github.com/circld/dotfiles --skill writing-skills-circld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that new and updated skills are robust, discoverable, and effectively guide AI agents by applying Test-Driven Development (TDD) principles to the skill authoring process. It prevents the creation of untested or poorly documented skills that lead to agent confusion and errors.

Core Features & Use Cases

  • TDD for Skills: Enforces the RED-GREEN-REFACTOR cycle for skill development, ensuring skills are written only after their necessity is proven by failing test scenarios.
  • Rationalization Prevention: Provides methods to identify and counter common excuses agents use to bypass rules, making skills more resilient under pressure.
  • Use Case: When developing a new skill for code review, you would first run scenarios where an agent without the skill makes mistakes. You document these failures, then write the skill to specifically address those mistakes, and finally, re-test under pressure to ensure compliance.

Quick Start

Use this skill when creating new skills, editing existing ones, or verifying their functionality before deployment.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I apply test-driven development to AI skill documentation?▼

Test-driven development for AI skill documentation enforces a RED-GREEN-REFACTOR cycle, ensuring skills are written only after failing test scenarios prove their necessity and guide agents effectively.

Why does my AI agent bypass documentation rules under pressure?▼

AI agents bypass documentation rules under pressure by using common rationalizations, which you can counter by identifying these excuses and making skills more resilient through specific testing scenarios.

What is the best way to verify AI skills before deployment?▼

The best way to verify AI skills before deployment is to run pressure scenarios where an agent without the skill makes mistakes, then document those failures and re-test to ensure compliance.

How do I prevent agent confusion when writing new skills?▼

Prevent agent confusion when writing new skills by applying TDD principles to the authoring process, ensuring documentation is robust, discoverable, and specifically addresses documented failure scenarios.

When do I need to use TDD principles for skill development?▼

You need to use TDD principles for skill development when creating new skills, editing existing ones, or verifying their functionality to prevent untested documentation that leads to agent errors.

Related Skills

Explore More Software Engineering Skills→
CrumbgrabberCrumbgrabber
3

writing-skills

Apply Test-Driven Development principles to create and refine AI skill documentation.

Community
Advanced
barrydobsonbarrydobson

Testing Skills With Subagents

Test skill documentation with RED-GREEN-REFACTOR cycles and pressure scenarios.

Community
Intermediate
viktorbezdekviktorbezdek
10

moai-workflow-testing

Automate end-to-end development workflows integrating testing, debugging, profiling, and code review.

Community
Advanced
quangphu1912quangphu1912
1

writing-skills

Develop and maintain AI agent skills with test-driven documentation.

Community
Advanced