Adapt test-driven development to agent skill documentation with YAML frontmatter.
npx skills add https://github.com/droxey/skills --skill writing-skills-droxey
Please help me install this Agent Skill. Skill: writing-skills Source: https://github.com/droxey/skills/tree/main/skills/writing-skills Command: npx skills add https://github.com/droxey/skills --skill writing-skills-droxey
It solves the problem of untested, brittle skill documentation that agents may misapply or partially follow under pressure, causing inconsistent behavior after deployment.
Use the writing-skills skill when creating or updating a skill document and you have not yet run a baseline scenario to confirm how agents fail without the skill.
High-intent search queries and answers about installing and using this skill.
Test-driven skill documentation adapts TDD by establishing failing baseline scenarios and verifying compliance after edits. This red-green-refactor cycle closes rationalization loopholes to prevent agents from misapplying instructions during deployment.
Test-driven skill authoring converts documentation changes into discipline-enforcing checks. It uses pressure scenarios and subagents to establish baseline failures, then verifies compliance after edits to prevent brittle, untested skill documentation from causing inconsistent agent behavior.
Skill discovery requires YAML frontmatter with a name field and a trigger-only description. Enforcing concise, trigger-focused metadata prevents skills from being skipped in agent directories due to workflow-summary descriptions.
Agents partially follow documentation under pressure due to rationalization loopholes. Untested, brittle skill documentation lacks explicit counters and red-flag stop conditions, causing inconsistent behavior when deployed.
Run a baseline scenario when creating or updating a skill document before making any edits. This confirms how agents fail without the skill, establishing a failing baseline that verifies compliance after subsequent documentation changes.
Skill documentation requires third-person rule wording to ensure agent compliance. This structural discipline enforces consistent instruction following by guiding writers to document exact failure reasons and close loopholes with explicit counters.
eduardoabreu81Create a standardized SKILL.md structure with name and description frontmatter fields.
totvsApply RED-GREEN-REFACTOR to validate AI skill documentation against pressure scenarios.
sunmin-ossApply RED-GREEN-REFACTOR cycles to author and verify agent skills.
LISANG3Apply TDD principles to create and maintain agent Skill documentation.
