Can this skill help with existing documentation?

Yes, it includes specific capabilities for reviewing, updating, and reorganizing existing specifications to improve their structure and clarity.

How does it handle test cases?

The skill provides dedicated workflows for adding, reviewing, and updating test cases that directly map back to the requirements defined in your specifications.

What is the OAPS integration mentioned in the skill?

OAPS stands for the Overengineered Agentic Planning System, which provides the underlying logic and command structure Claude uses to orient itself and load relevant references for your task.

What is the primary purpose of the Specification Writing skill?

It provides a standardized, agentic workflow for creating and maintaining high-quality technical documentation, ensuring that requirements and behaviors are clearly defined.

Specification Writing

Name: Specification Writing
Author: tbhb

bytbhb

0•

Learning & Documentation

Streamlines the creation, review, and management of comprehensive technical specifications and formal requirements.

The Specification Writing skill provides a structured framework for Claude to develop high-quality technical documentation, covering everything from initial requirement gathering to test case design. Built on the Overengineered Agentic Planning System (OAPS), it ensures that specifications are consistent, well-organized, and serve as an authoritative reference for development teams. By guiding users through progressive disclosure of references and mandatory context-loading steps, the skill helps eliminate ambiguity in system behaviors and interfaces, making it an essential tool for architects and lead developers.

Key Features

01Structured requirement management including adding, moving, and updating criteria

02Automated organization and splitting of complex specification documents

03Integrated test case design and validation alignment

04Dynamic context loading for specific specification standards and workflows

05Best practice guidance for technical formatting and clear documentation

060 GitHub stars

Use Cases

01Generating a formal technical design document for a new system architecture

02Refining and auditing existing project requirements for clarity and testability

03Managing the lifecycle of test cases to ensure full coverage of specified behaviors

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tbhb/oaps spec-writing

For use in Claude.ai and ChatGPT

Download Skill