writing-skills

Create, edit, and verify AI skills using test-driven development cycles.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/wangx7/skills-collection --skill writing-skills-wangx7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/wangx7/skills-collection/tree/main/superpowers-main/skills/writing-skills
Command: npx skills add https://github.com/wangx7/skills-collection --skill writing-skills-wangx7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating effective AI skills requires more than just writing documentation - it demands testing under pressure, bulletproofing against agent rationalization, and optimizing for discovery. Without a systematic approach, skills remain untested, ambiguous, and ignored when they matter most.

Core Features & Use Cases

  • TDD for Documentation: Applies test-driven development to skill creation with RED-GREEN-REFACTOR cycles, baseline testing with subagents, and pressure scenarios that reveal compliance failures.
  • Bulletproofing Techniques: Provides explicit counters for agent rationalizations, red flag lists, and foundational principles that prevent discipline-enforcing skills from being bypassed under pressure.
  • Discovery Optimization: Teaches how to write descriptions that trigger correctly, use keyword coverage for searchability, and structure skills for progressive disclosure to minimize token usage.

Quick Start

Use the writing-skills skill to create a new skill by first running a baseline pressure scenario without the skill, documenting the agent's failures, then writing minimal documentation that addresses those specific violations before re-testing.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I test process documentation for AI agents before deployment?

Test process documentation for AI agents by applying test-driven development (TDD) with RED-GREEN-REFACTOR cycles, running baseline pressure scenarios using subagents, and documenting specific compliance failures to address before re-testing.

What is test-driven development for AI skill creation?

Test-driven development for AI skill creation is a methodology applying RED-GREEN-REFACTOR cycles to process documentation, using subagent dispatch for baseline testing and pressure scenarios to reveal agent compliance failures before finalizing the skill.

How can I prevent AI agents from bypassing discipline-enforcing skills under pressure?

Prevent AI agents from bypassing discipline-enforcing skills under pressure by applying bulletproofing techniques, including explicit counters for agent rationalizations, red flag lists, and foundational principles that enforce strict compliance.

How do I optimize AI skill discovery through description fields?

Optimize AI skill discovery through description fields by writing descriptions that trigger correctly, using keyword coverage for searchability, and structuring skills with YAML frontmatter and progressive disclosure patterns to minimize token usage.

Do I need to understand subagent dispatch to create effective agent skills?

Yes, creating effective agent skills requires understanding subagent dispatch for baseline testing, alongside YAML frontmatter standards and progressive disclosure patterns, to properly pressure-test and validate process documentation.

What's the best way to structure AI skills for progressive disclosure?

The best way to structure AI skills for progressive disclosure is to use YAML frontmatter for metadata standards, optimize description fields for keyword coverage, and minimize token usage while ensuring skills trigger correctly during search.