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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents agents from “getting it mostly right” when authoring skills by requiring test-driven, failure-informed documentation that resists loopholes under pressure.

Core Features & Use Cases

  • Test-Driven Skill Authoring: Converts skill creation into a RED-GREEN-REFACTOR loop using pressure scenarios and observed rationalizations.
  • Compliance Under Pressure: Forces validation that agents still follow instructions when time, sunk cost, authority, or exhaustion make violations tempting.
  • Loophole Hardening: Identifies new excuses after GREEN, adds explicit negations/counters, and re-verifies until the rule stays intact.

Quick Start

Use writing-skills to create or update a skill, then run baseline pressure scenarios without the skill to capture the exact failures and rationalizations before writing any instructions.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write process documentation that prevents AI agents from rationalizing rule violations under pressure?

Test-driven skill authoring applies RED-GREEN-REFACTOR cycles to process documentation, using baseline pressure scenarios to capture and harden against agent rationalizations before finalizing instructions. It ensures agent behavior matches documented rules.

What is test-driven development for skill authoring and how does it work?

Test-driven skill authoring is a method that treats documentation like code. It requires capturing baseline failures without the skill, writing minimal instructions to pass, then identifying new rationalizations and adding explicit negations to re-verify compliance.

How do I verify agent compliance when exhaustion, sunk cost, or authority pressure makes violations tempting?

Verify agent compliance under pressure by running explicit pressure scenarios that test time, sunk cost, authority, and exhaustion constraints. This loophole hardening process identifies rationalizations and tests that agents still follow documented rules.

Does test-driven skill authoring require dependencies or specific testing frameworks to verify agent behavior?

Test-driven skill authoring requires no external dependencies or frameworks. It relies entirely on running baseline pressure scenarios against your agent, observing rationalizations, and updating minimal instructions to harden process documentation compliance.

What is the best way to prevent AI agents from finding loopholes in process documentation?

The best way to prevent loopholes is loophole hardening: after passing initial tests, identify new rationalizations agents use under pressure, add explicit negations or counters to the instructions, and re-test until the rule remains intact.

When should I not use TDD methods for process documentation?

Avoid TDD for process documentation when rules are highly subjective or lack clear pass/fail pressure scenarios. The method requires explicit baseline failures and observable rationalizations to successfully harden agent compliance.