openagent-writing-skills

Validate OpenAgent skills using a structured RED-GREEN-REFACTOR workflow with pressure scenarios to verify readiness. This test-driven approach surfaces documentation gaps and ensures safe deployment in OpenCode and OpenAgent contexts through baseline testing and rigorous refactoring.

Test-driven documentation for skill authoring applies the RED-GREEN-REFACTOR cycle to SKILL.md files to surface gaps and ensure reliability. It involves baseline testing, minimal skill creation, and rigorous refactoring to close loopholes and improve content consistency.

Structure SKILL.md files with required YAML frontmatter including name and description, using optional references and progressive-disclosure organization to keep content concise. This approach surfaces essential guidance first while deferring detailed context to referenced sections.

Yes, quality assurance checklists, rationalization tables, and red flags govern skill writing workflows to improve consistency and enforce safe practices. These governance tools identify baseline gaps, verify test coverage, and close loopholes during the refactoring phase.

Refactor existing OpenAgent skills safely by applying the REFACTOR phase after RED-GREEN baseline testing, using checklists and cross-skill references to close loopholes. This structured lifecycle ensures edits maintain quality governance and documentation consistency before deployment.

You need a structured workflow for process documentation when teams design new skills, edit existing ones, or verify skill readiness before deployment. A test-driven, repeatable process codifies best practices and ensures documentation reliability through pressure scenario validation.