writing-skills

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

2.4k|145|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/HughYau/AcademicForge --skill writing-skills-hughyau
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/HughYau/AcademicForge/tree/main/skills/superpowers/writing-skills
Command: npx skills add https://github.com/HughYau/AcademicForge --skill writing-skills-hughyau

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 robust, discoverable, and effective by preventing common pitfalls and rationalizations.

Core Features & Use Cases

  • Test-Driven Skill Development: Adapts the RED-GREEN-REFACTOR cycle to skill documentation.
  • Pressure Scenario Testing: Simulates real-world constraints (time, sunk cost, authority) to test skill compliance.
  • Rationalization Countermeasures: Explicitly addresses and closes loopholes agents use to bypass rules.
  • Use Case: When developing a new skill for code review, use this skill's methodology to write failing tests first, then the skill, and finally refactor to ensure agents adhere to review standards even under tight deadlines.

Quick Start

Follow the RED-GREEN-REFACTOR cycle to create a new skill, starting with writing a failing test scenario.

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 to develop AI skills?

To use TDD for AI skill development, you write failing test scenarios first, create minimal skills to pass those tests, and refactor to close loopholes. This RED-GREEN-REFACTOR cycle ensures skills are robust and compliant.

What is pressure scenario testing for agentic workflows?

Pressure scenario testing simulates real-world constraints like time, sunk cost, and authority to test AI skill compliance. It ensures agents adhere to rules even under tight deadlines or conflicting priorities in agentic workflows.

Why do AI agents bypass rules and how can I prevent rationalizations?

AI agents bypass rules by finding loopholes in skill documentation to rationalize non-compliance. You prevent rationalizations by explicitly addressing and closing these loopholes during the refactoring phase of test-driven skill development.

How to refactor skill documentation to improve discoverability and compliance?

Refactor skill documentation by closing loopholes agents use to bypass rules, ensuring explicit compliance standards. This test-driven refactoring improves skill discoverability and effectiveness in agentic workflows.

Can I apply test-driven development to documentation for code review skills?

Yes, you can apply test-driven development to documentation for code review skills. Write failing test scenarios under pressure constraints first, then develop the minimal skill, ensuring agents adhere to review standards even under tight deadlines.

What are the limitations of using TDD for skill creation?

A limitation of using TDD for skill creation is the need to anticipate rationalizations and pressure scenarios accurately. If failing test scenarios do not simulate real-world constraints properly, agents may still bypass the intended rules.