hf-spec-review

Evaluate software specification drafts for ambiguity and readiness.

1|Updated Mar 22, 2026

Search Tags:#requirements #ambiguity #software-engineering #findings #spec-review #quality-attributes #open-issues

Ready to run

npx skills add https://github.com/hujianbest/garage-agent --skill hf-spec-review

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: hf-spec-review
Source: https://github.com/hujianbest/garage-agent/tree/main/packs/coding/skills/hf-spec-review
Command: npx skills add https://github.com/hujianbest/garage-agent --skill hf-spec-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze software specifications to identify ambiguity, incompleteness, and open questions, ensuring they are production-ready for downstream design and approval processes.

Core Features & Use Cases

Rubric-based review to quantify quality attributes and ensure traceability from sources
Detect fuzziness, oversized requirements, missing acceptance criteria, and unresolved open questions
Generate structured review records with classifications (USER-INPUT, LLM-FIXABLE) and recommended next steps
Accepts specs aligned with AGENTS.md templates and supports deferral handling for rework via hf-specify

Quick Start

Submit your current spec draft to hf-spec-review to generate a structured evaluation and actionable next steps.

Frequently Asked Questions about hf-spec-review

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

FAQPage Schema

How do I identify ambiguity and missing acceptance criteria in a software specification?▼

Spec review analyzes software specifications to identify fuzziness, oversized requirements, missing acceptance criteria, and open questions. It applies a rubric-based evaluation to quantify quality attributes and ensure traceability from sources.

How do I check if my spec draft is ready for downstream design and approval?▼

Spec review evaluates specification drafts for readiness by detecting incompleteness and unresolved open questions. It produces a structured review record with a clear conclusion and recommended next steps to support accurate handoffs.

Does spec review work with specifications following AGENTS.md templates?▼

Spec review accepts specs aligned with AGENTS.md templates. It evaluates these stable specification drafts to detect fuzziness and missing acceptance criteria, generating categorized findings for production readiness.

What is the best way to classify unresolved open questions found during a spec review?▼

Spec review classifies findings into categories such as USER-INPUT and LLM-FIXABLE. This structured approach helps identify which open questions require manual clarification versus automated rework.

How do I handle spec rework and deferral after finding open issues in a specification?▼

Spec review supports deferral handling for rework via hf-specify. It outputs categorized findings and recommended next steps to route the specification back for necessary revisions.

When should I not use an automated spec review for my software requirements?▼

Spec review applies to stable specifications that follow AGENTS.md templates. It should not be used for incomplete drafts or specifications that do not adhere to the required template structure.