One-click install
npx skills add https://github.com/wenerme/ai --skill writing-skills-wenerme
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/wenerme/ai/tree/main/skills/writing-skills
Command: npx skills add https://github.com/wenerme/ai --skill writing-skills-wenerme

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill reduces the risk that newly written or edited agent skills are unclear or non-compliant by forcing a test-first loop before deployment, mirroring RED-GREEN-REFACTOR for documentation.

Core Features & Use Cases

  • TDD for process documentation: Turns skill authoring into pressure-tested requirements instead of intuition.
  • Pressure scenario testing: Uses realistic subagent pressure scenarios to capture exact rationalizations and failure modes.
  • Loophole hardening: Refactors the skill text by adding explicit negations, counters, red flags, and improved discovery metadata to prevent repeat violations.

Quick Start

Use the writing-skills workflow to create failing pressure scenarios first, then iteratively update the target SKILL.md until the same scenarios reliably comply.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I use test-driven documentation to harden agent skills?

Test-driven documentation hardens agent skills by applying a RED-GREEN-REFACTOR cycle to authoring. You create failing pressure scenarios first, capture baseline failures with verbatim rationalizations, then iteratively update the skill text until scenarios reliably comply.

What is pressure scenario testing for skill authoring?

Pressure scenario testing for skill authoring uses realistic subagent scenarios to evaluate skill documentation. It captures exact rationalizations and failure modes under combined pressures, enabling targeted loophole hardening through minimal skill edits and repeated re-verification.

How do I write bulletproof agent skills that prevent rationalizations?

You write bulletproof agent skills by designing pressure scenarios that expose rationalization countermeasures. Capture baseline failures verbatim, apply minimal edits to add explicit negations and red flags to the SKILL.md, and re-verify to close loopholes.

Can I verify skill compliance under multiple combined pressures simultaneously?

Yes, you can verify skill compliance under multiple combined pressures simultaneously using subagents. The workflow requires capturing baseline failures, applying minimal skill edits to address observed violations, and repeating re-verification until all loopholes are closed.

What is the best way to refactor skill text to close documentation loopholes?

The best way to refactor skill text to close documentation loopholes is by adding explicit negations, counters, and red flags. This targeted loophole hardening prevents repeat violations discovered during pressure scenario testing and improves discovery metadata.

When should I not use the test-first loop for skill authoring?

You should not use the test-first loop for skill authoring when deploying documentation without compliance risks. If intuition-based authoring suffices and pressure scenario testing or subagent verification is unnecessary, this cycle adds overhead without proportionate benefit.