workspace-spec-linter

Validate software specifications for ambiguity, structure, and testability.

1|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/hohai99/antigravity-skills --skill workspace-spec-linter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace-spec-linter
Source: https://github.com/hohai99/antigravity-skills/tree/main/.agent/skills/workspace-spec-linter
Command: npx skills add https://github.com/hohai99/antigravity-skills --skill workspace-spec-linter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps product teams and engineers avoid costly miscommunications by automatically checking project specifications for clarity, structure, and testability.

Core Features & Use Cases

  • Ambiguity Detection: flags vague language and proposes concrete constraints.
  • Structure Enforcement: verifies conformance to the spec-template and ensures traceability.
  • Decision Logging: highlights open questions and decisions to prevent scope drift.

Quick Start

  • Run the workspace-spec-linter against your current spec document before freezing changes to surface ambiguities and ensure testability.

Frequently Asked Questions about workspace-spec-linter

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

FAQPage Schema
How do I check software specifications for ambiguity and testability?

To check software specifications for ambiguity and testability, you can lint the spec document to automatically flag vague language, enforce structural conformance, and log open questions for decision making before implementation.

What is specification linting and when do I need it?

Specification linting is the automated process of validating spec documents for clarity and testability. You need it during Planning, Migration, and Spec-Review phases to catch ambiguities and structural issues before freezing changes.

How do I enforce structure and traceability in project specifications?

To enforce structure and traceability in project specifications, run a linter that verifies conformance to the spec-template structure and assigns traceability IDs to catch governance issues early.

Can I use a spec linter to prevent scope drift during migration?

Yes, you can use a spec linter during migration phases to prevent scope drift by highlighting open questions and logging decisions, ensuring all constraints are concretely defined before implementation.

What is the best way to surface open questions in software specifications?

The best way to surface open questions in software specifications is to lint the document for decision logging, which automatically highlights unresolved questions to prevent miscommunications and scope drift.