writing-skills

Apply Test-Driven Documentation to create and verify skills through iterative refinement.

8|1|Updated Feb 25, 2022
One-click install
npx skills add https://github.com/ayubun/dotfiles --skill writing-skills-ayubun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/ayubun/dotfiles/tree/main/configs/opencode/skills/ed3d-extending-opencode/writing-skills
Command: npx skills add https://github.com/ayubun/dotfiles --skill writing-skills-ayubun

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of creating, editing, and verifying skills by applying Test-Driven Documentation (TDD) principles to process documentation, ensuring skills are robust and reliable.

Core Features & Use Cases

  • Test-Driven Documentation: Documents through the lens of test cases, iteratively refining skills until they are bulletproof against rationalization.
  • Skill Creation: Guides the creation of new skills, editing existing ones, and verifying their functionality.
  • Use Case: When developing a new skill for a project, use this Skill to first create and test scenarios with subagents before writing the skill, ensuring it meets all requirements.

Quick Start

Run the writing-skills skill to generate test cases for a new skill, iterate on the skill's implementation, and ensure it passes all test scenarios.

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 documentation to skill creation?

Test-driven documentation for skill creation involves generating pressure scenarios for subagents, iteratively refining the skill's process documentation, and verifying it passes all tests to ensure robustness against rationalization.

What is the best way to verify process documentation against rationalization?

The best way to verify process documentation is by creating pressure scenarios for subagents. You iteratively test and refine the documentation until the skill is bulletproof and resists rationalization during execution.

How do I create test cases for subagent testing before writing a skill?

To create test cases for subagent testing, run the skill generation process to define pressure scenarios first. You then iterate on the skill's implementation based on subagent feedback until it meets all requirements.

Do I need subagent testing skills to document a process?

Yes, subagent testing skills are required. The documentation process relies on creating pressure scenarios for subagents to validate the process and ensure the final skill is robust against rationalization.

When should I use test-driven documentation for editing existing skills?

Use test-driven documentation when editing existing skills to ensure modifications do not introduce rationalization vulnerabilities. It validates changes through subagent pressure scenarios and iterative refinement.

Why does my skill fail under subagent pressure scenarios?

Skills fail under subagent pressure scenarios when the process documentation lacks iterative refinement. Test-driven documentation addresses this by continuously testing against scenarios until the skill becomes bulletproof.