harness-spec

Generate structured technical specifications with acceptance criteria and risk validation.

Updated Jun 6, 2026
One-click install
npx skills add https://github.com/kekemoto/skills --skill harness-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-spec
Source: https://github.com/kekemoto/skills/tree/main/skills/harness-spec
Command: npx skills add https://github.com/kekemoto/skills --skill harness-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the ambiguity in software development by forcing a clear distinction between what needs to be achieved and how it is implemented, preventing scope creep and ensuring verifiable outcomes.

Core Features & Use Cases

  • Spec Authoring: Automatically drafts specifications based on conversation context, focusing on acceptance criteria rather than implementation details.
  • Project Scoping: Manages project-specific directories and ensures that every unit of work is tied to a clear, verifiable PR.
  • Use Case: When starting a new feature, use this skill to generate a structured specification file that defines the acceptance criteria, scope, and potential risks, ensuring the implementation phase has a clear roadmap.

Quick Start

Use the harness-spec skill to draft a new specification for the user authentication module within the current project.

Frequently Asked Questions about harness-spec

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

FAQPage Schema
How do I write technical specifications for predictable PRs?

To write technical specifications for predictable PRs, draft a structured spec file defining clear acceptance criteria and verifiable outcomes. This enforces a WHAT-over-HOW documentation standard, separating project scope from implementation details to prevent scope creep.

What is a WHAT-over-HOW documentation standard for software development?

A WHAT-over-HOW documentation standard for software development focuses strictly on defining acceptance criteria and verifiable outcomes rather than implementation details. This approach prevents ambiguity and scope creep by standardizing what needs to be achieved over how it is built.

How do I manage feature-based PR workflows using project-scoped directories?

You can manage feature-based PR workflows using project-scoped directories by generating structured specifications tied to specific project paths. This approach validates requirements against risk criteria and establishes clear dependency ordering for software development units.

Can I validate development requirements against risk criteria before starting implementation?

Yes, you can validate development requirements against risk criteria before implementation. The specification generation process assesses potential risks during the drafting phase, ensuring the implementation roadmap has verifiable outcomes and clear acceptance criteria.

Does harness-spec work for standardizing development specs across multiple features?

harness-spec works for standardizing development specs across multiple features by operating within project-scoped directories. It manages feature-based PR workflows and validates dependency ordering, ensuring each unit of work maintains consistent acceptance criteria.

Limitations of enforcing acceptance criteria over implementation details in software specs?

Enforcing acceptance criteria over implementation details in software specs intentionally limits documentation to verifiable outcomes. This means the generated specification will not provide implementation roadmaps, requiring developers to determine the HOW independently during the development phase.