spec-observation

Identify specification ambiguities and formalize acceptance criteria in Given/When/Then format.

1|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/CAPHTECH/claude-marketplace --skill spec-observation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-observation
Source: https://github.com/CAPHTECH/claude-marketplace/tree/main/caphtech-plugin/skills/spec-observation
Command: npx skills add https://github.com/CAPHTECH/claude-marketplace --skill spec-observation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Identifies specification ambiguities, formalizes acceptance criteria, and generates testable specs before implementation.

Core Features & Use Cases

  • Capture assumptions log for undecided aspects
  • Produce Given/When/Then acceptance criteria examples
  • Generate test templates from spec observations

Quick Start

Given a feature request with vague requirements, call this Skill to surface assumptions and concrete acceptance criteria.

Frequently Asked Questions about spec-observation

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

FAQPage Schema
How do I identify ambiguities in feature specifications before development starts?

Identifying specification ambiguities early surfaces implicit assumptions and prevents misinterpretation during implementation. This Skill analyzes feature requests and requirements to extract unclear aspects, formalize acceptance criteria in Given/When/Then format, and generate concrete testable scenarios that clarify intent before code review.

What's the best way to document acceptance criteria from vague requirements?

Formalizing acceptance criteria from vague requirements involves capturing assumptions, structuring criteria in Given/When/Then format, and producing an assumptions-log artifact. This approach creates explicit, testable specifications that prevent scope creep and align development, QA, and stakeholders on expected behavior.

Can I generate test templates directly from specification observations?

Yes. This Skill extracts specification ambiguities and generates test code templates for acceptance and regression checks. The templates translate formalized acceptance criteria into executable test scenarios, enabling QA to validate implementation against concrete, documented requirements.

When should I surface specification ambiguities in the development workflow?

Surface specification ambiguities during new feature design, requirements reviews, and when specs are unclear or evolving. Identifying issues at these stages prevents rework, reduces PR cycle time, and ensures acceptance criteria are testable before implementation begins.

How do I extract implicit assumptions from incomplete specifications?

Extracting implicit assumptions reveals undecided or unclear aspects in specifications. This Skill documents these assumptions in a log, formalizes edge cases, and produces concrete acceptance criteria. This practice prevents conflicting interpretations and creates a reference for stakeholder alignment.

What's the difference between vague requirements and well-formed acceptance criteria?

Vague requirements lack clarity on expected behavior and edge cases; well-formed acceptance criteria use Given/When/Then structure to specify testable outcomes. This Skill transforms the former into the latter, ensuring QA has concrete scenarios for validation and developers have unambiguous implementation targets.