spec-score

Evaluate specification file quality with an LLM-as-judge scorecard.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/DMokong/speculator --skill spec-score
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-score
Source: https://github.com/DMokong/speculator/tree/main/skills/spec-score
Command: npx skills add https://github.com/DMokong/speculator --skill spec-score

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the evaluation of specification quality, ensuring that development requirements are clear, complete, and meet predefined standards before implementation begins.

Core Features & Use Cases

  • Automated Quality Scoring: Leverages an LLM-as-judge to provide objective scores on spec quality dimensions.
  • Actionable Feedback: Identifies specific areas for improvement with clear flags and explanations.
  • Gate 1 Enforcement: Acts as the first quality gate in a development pipeline, preventing low-quality specs from proceeding.
  • Use Case: Before starting to code a new feature, run this Skill to get an immediate assessment of your spec's readiness, ensuring alignment and reducing rework.

Quick Start

Run the spec-scorer agent to evaluate the quality of the specification file.

Frequently Asked Questions about spec-score

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

FAQPage Schema
How do I evaluate specification quality before starting development?

To evaluate specification quality, you can use an LLM-as-judge agent to automatically score a spec file against quality standards. This generates a detailed scorecard that identifies specific areas for improvement, reducing rework before implementation begins.

What is an LLM-as-judge agent for development workflow gates?

An LLM-as-judge agent for development workflows is an automated evaluator that scores requirement specifications for completeness and clarity. It acts as a quality gate to prevent ambiguous or incomplete specs from proceeding into the coding phase.

How do I automate spec quality scoring for a new feature?

You automate spec quality scoring by running a scorer agent that requires a project configuration and the spec file path. The agent evaluates the document and outputs an objective scorecard with actionable feedback and flags.

Do I need a project configuration to run a spec quality evaluation?

Yes, you need a project configuration and the spec file path to run a spec quality evaluation. These inputs are required for the LLM-as-judge agent to understand the context and generate an accurate quality scorecard.

When should I enforce a specification quality gate in an agentic workflow?

You should enforce a specification quality gate at the initial stage of an agentic development workflow. Applying this gate before coding ensures that requirement specs meet predefined completeness standards and prevents low-quality inputs.