validate-specs

A specification-checking workflow for comparing a BRD, which describes business needs, with a PRD, which describes product requirements. It checks whether the documents cover the same requirements and are technically feasible.

In plain words
What is it for?
Use it to validate BRD and PRD alignment when both documents and the project's technical-stack file are available.
Why use it?
It finds missing requirements, contradictions, and inconsistent terms before they reach implementation.

Skill for Claude CodeCodex

Part of the transmuter plugin — 23 skills, 1 command, 7 agents shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/voxtechnologies/transmute-framework/validate-specs
Any agent
npx skills add VoxTechnologies/transmute-framework --skill validate-specs
Clone the repo
git clone --depth 1 https://github.com/VoxTechnologies/transmute-framework

Made for: Claude Code, Codex.

Or install transmuter, the plugin that ships this one along with the rest of its 23 skills, 1 command, 7 agents.

Per session 92 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,399 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00092 $0.04399
Opus 5 $0.00046 $0.02200
Sonnet 5 $0.00018 $0.00880
Haiku 4.5 $0.00009 $0.00440

Measured 2d ago against content hash 6eea5b44942f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

validate-specs scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/validate-specs/SKILL.md · 251 lines

How it starts

The opening of the file, as written. The whole thing — 251 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Transmute — Specification Validation (Stage 2B)

Read the detailed guide at ${CLAUDE_SKILL_ROOT}/references/validate-specs-detailed-guide.md for the complete validation procedures, teammate spawn prompts, and report templates.

Prerequisites

Before starting, verify:

  1. ./plancasting/brd/ directory exists and contains markdown files. If missing, STOP: "Stage 2B requires completed BRD (Stage 1). Run Stage 1 first."
  2. ./plancasting/prd/ directory exists and contains markdown files. If missing, STOP: "Stage 2B requires completed PRD (Stage 2). Run Stage 2 first."
  3. ./plancasting/tech-stack.md exists. If missing, STOP: "Stage 2B requires plancasting/tech-stack.md from Stage 0. Run Stage 0 first."

Purpose

Independently cross-validate the BRD and PRD for consistency, completeness, and correctness — catching errors before they propagate into code. The BRD and PRD are generated by separate Agent Team sessions, so several categories of errors can slip through:

  • BRD requirements overlooked or misinterpreted during PRD generation
  • PRD specifications that contradict BRD constraints
  • Terminology inconsistencies between documents
  • Missing user stories for functional requirements
  • Screen specs that don't match user flow descriptions
  • API specs that don't cover all screen data needs
  • Untestable acceptance criteria
  • Cross-feature interactions documented in BRD but missing from PRD

Fixing these now costs minutes. Fixing them after code is written costs hours.

Inputs

Read:

  • All files in ./plancasting/brd/, including _context.md
  • All files in ./plancasting/prd/, including _context.md and _brd-issues.md (if exists — contains BRD quality issues pre-identified during PRD generation; map classifications: BLOCKING → CRITICAL, CRITICAL-BUT-RECOVERABLE → HIGH, NON-BLOCKING → MEDIUM/LOW)
  • All files in ./plancasting/businessplan/
  • ./plancasting/tech-stack.md for technical feasibility checks
  • ./plancasting/brd/_review-log.md and ./plancasting/prd/_review-log.md if they exist

Read the full file on GitHub · 251 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 251 lines · 92 tokens per session scan A 6eea5b44942f

Subscribe to this mod's changes

validate-specs is a skill published in the GitHub repository VoxTechnologies/transmute-framework (4 stars, last pushed 1mo ago), licensed MIT. It adds 92 tokens to every session and 4,399 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

knowledge-base

Create and maintain a Markdown knowledge base that any AI agent can read, search, and update. Use when the user wants to start a knowledge base, add or update notes, organize docs/notes for an agent or LLM to consume, build an index of notes, or run a cleanup/maintenance pass on an existing MD knowledge base. Triggers…

wonderwhy-er/DesktopCommanderMCP · 112 tokens

code-review

Use when code has been written and needs validation before committing, or when the user asks for a code review or security check.

darrenhinde/OpenAgentsControl · 28 tokens

test-generation

Use when the user asks for tests, mentions TDD, or when new code has been written and needs test coverage.

darrenhinde/OpenAgentsControl · 27 tokens

scientific-schematics

Create publication-quality scientific diagrams using Nano Banana 2 AI with smart iterative refinement. Uses Gemini 3.1 Pro Preview for quality review. Only regenerates if quality is below threshold for your document type. Specialized in neural network architectures, system diagrams, flowcharts, biological pathways…

xintaofei/codeg · 68 tokens

statistical-power

Sample-size and statistical power calculations for planning studies. Use whenever someone asks "how many subjects/samples/replicates do I need", wants an a priori power analysis, a minimum detectable effect (MDE), a power curve, or needs to justify a sample size for a grant, IRB protocol, or pre-registration. Covers…

xintaofei/codeg · 190 tokens

build-teaql-app

Build or change a TeaQL application in Java, Rust, Go, Swift, Python, C#/.NET, or TypeScript, including Kotlin/JVM applications that consume Java-generated libraries. Mandatory order: first draft and save a complete KSML model, then verify the client and evaluate that saved model, repair it through repeated evaluation…

teaql/teaql-agent-kit · 112 tokens