writing-skills

Create and refine AI skills using a RED-GREEN-REFACTOR test-driven cycle.

Updated Oct 21, 2022
One-click install
npx skills add https://github.com/Chengxufeng1994/dotfiles --skill writing-skills-chengxufeng1994
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/Chengxufeng1994/dotfiles/tree/main/gemini/antigravity/global_skills/writing-skills
Command: npx skills add https://github.com/Chengxufeng1994/dotfiles --skill writing-skills-chengxufeng1994

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 rationalization.

Core Features & Use Cases

  • Test-Driven Skill Development: Apply the RED-GREEN-REFACTOR cycle to skill documentation.
  • Rationalization Prevention: Learn techniques to bulletproof skills against AI attempts to bypass rules.
  • Use Case: When developing a new skill for code review, use this skill's methodology to write pressure scenarios that test compliance under time constraints and ensure the skill is followed precisely.

Quick Start

Follow the RED-GREEN-REFACTOR process outlined in this skill's documentation to create a new skill.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I prevent AI agents from rationalizing and bypassing skill rules under pressure?

Test-driven skill development prevents AI rationalization by applying a strict RED-GREEN-REFACTOR cycle to documentation. This methodology enforces pressure scenario testing and explicit loophole closure, ensuring AI agents cannot bypass rules under constraints.

What is the RED-GREEN-REFACTOR cycle for AI skill documentation?

The RED-GREEN-REFACTOR cycle for AI skill documentation is a Test-Driven Development methodology that structures skill creation. It involves writing failing pressure tests first, refining documentation to pass them, and restructuring to eliminate rationalization loopholes.

How to create AI skills that are effective and discoverable?

To create effective and discoverable AI skills, apply a test-driven framework that enforces rigorous documentation standards. This approach ensures skills remain precise and resistant to rationalization, addressing common discoverability and effectiveness problems.

Does test-driven development work for AI agent skill creation?

Test-driven development works for AI agent skill creation by adapting the RED-GREEN-REFACTOR cycle to documentation. It validates skill compliance through pressure scenario testing, ensuring the resulting skills are robust against rule bypass attempts.

When do I need to use pressure scenario testing for skill development?

You need pressure scenario testing for skill development when creating skills that must perform reliably under constraints, such as time limits. It verifies that AI agents follow the skill precisely instead of rationalizing rule deviations under pressure.

What are the limitations of using TDD for AI skill documentation?

A limitation of using TDD for AI skill documentation is the strict requirement to continuously write and maintain pressure scenarios. If scenarios do not accurately anticipate agent behavior, loopholes may remain unclosed, allowing rationalization to bypass rules.