skills.rest
hujianbest
hujianbestCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/hujianbest/garage-agent --skill hf-spec-review
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
FS-GGFS-GG

fs-gg-sdd-specify

Generate YAML specification drafts with stable IDs for the FS.GG SDD lifecycle.

Official
Intermediate
hujianbesthujianbest
1

using-hf-workflow

Decide between direct leaf skill invocation and workflow router routing.

Community
Intermediate
andreadellacorteandreadellacorte
5

groove-work-review

Evaluate git diffs against acceptance criteria and categorize findings into fix or rework decisions.

Community
Intermediate
Fr-e-dFr-e-d
157

refine-scope

Refine Discovery artefacts by addressing ambiguity and missing acceptance criteria.

Community
Intermediate