writing-skills

Apply the RED-GREEN-REFACTOR cycle to skill documentation.

Updated Jan 16, 2026
One-click install
npx skills add https://github.com/davzucky/lazygitlab --skill writing-skills-davzucky
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/davzucky/lazygitlab/tree/main/.opencode/skills/writing-skills
Command: npx skills add https://github.com/davzucky/lazygitlab --skill writing-skills-davzucky

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a rigorous, test-driven framework for creating and refining AI skills, ensuring they are discoverable, effective, and robust against common rationalizations.

Core Features & Use Cases

  • Test-Driven Skill Development: Apply the RED-GREEN-REFACTOR cycle to skill documentation.
  • Rationalization Countermeasures: Learn to anticipate and explicitly block AI attempts to bypass rules.
  • Use Case: When developing a new skill for enforcing coding standards, use this Skill's methodology to write failing test scenarios first, then build the skill to address those specific failures, ensuring compliance under pressure.

Quick Start

Use the writing skills skill to create a new skill for validating commit messages.

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 skill development applies the RED-GREEN-REFACTOR cycle to documentation by writing failing test scenarios first, then building the skill to address those specific failures. This ensures compliance under pressure.

Why does my AI agent bypass documentation rules during skill development?

AI agents often bypass documentation rules through rationalization. You can counter this by anticipating rationalization attempts and explicitly blocking them within the skill's test scenarios and rules.

What is the best way to ensure AI skill discoverability and agent compliance?

The best way to ensure AI skill discoverability and agent compliance is enforcing a rigorous test-driven development methodology across the entire skill authoring lifecycle, from initial concept to deployment.

How do I refactor AI skills to prevent common documentation pitfalls?

You refactor AI skills by applying test-driven principles adapted for documentation, verifying robustness against common pitfalls through rigorous testing scenarios during the refactoring phase of the development cycle.

Can I use TDD for the entire lifecycle of skill authoring?

Yes, test-driven development applies to the entire lifecycle of skill authoring from initial concept to deployment, ensuring documentation remains robust, discoverable, and resistant to rationalization throughout.