writing-skills

Write and validate Skills using a RED-GREEN-REFACTOR test-driven workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing and validating Skills can be error-prone and inconsistent without a disciplined process. This guide provides an enforceable framework to design, test, and iterate Skills using a RED-GREEN-REFACTOR lifecycle with subagents to prevent rationalizations and ensure robust deployment.

Core Features & Use Cases

  • Establishes a test-driven workflow for skill creation and refinement (RED-GREEN-REFACTOR).
  • Documents baseline failures, rationalizations, counters, and red-flag patterns to harden Skills.
  • Supports structured Skill packaging that can include references to supporting guides, tests, and tooling.
  • Applicable to creating new Skills or auditing/editing existing Skills for reliability under pressure.

Quick Start

Follow the RED-GREEN-REFACTOR cycle: run baseline tests without the Skill, write the Skill to address observed failures, and re-test to verify compliance.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I validate reusable skills using a test-driven workflow?

You validate reusable skills by applying a strict test-driven development workflow that enforces structured frontmatter, modular references, and iterative refinement to ensure robust deployment and reliability.

What is the RED-GREEN-REFACTOR cycle for skill creation?

The RED-GREEN-REFACTOR cycle for skill creation involves running baseline tests without the skill, writing the skill to address observed failures, and re-testing to verify compliance and harden the skill.

How do I track rationalizations and red flags when writing skills?

You track rationalizations and red flags by documenting baseline failures, rationalizations, counters, and red-flag patterns during the test-driven workflow, which hardens skills against errors under pressure.

Can I use a TDD approach to audit existing skills under pressure?

Yes, you can use this test-driven approach to audit and edit existing skills, ensuring their reliability and discoverability under pressure by applying the structured RED-GREEN-REFACTOR lifecycle.

Does structured frontmatter improve skill discoverability and reliability?

Structured frontmatter improves discoverability and reliability by enforcing a consistent, modular packaging format that supports references to supporting guides, tests, and tooling.