spec-critic SKILL.md skillA

spec-critic from vmobifystudio/app-dev-team is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add vmobifystudio/app-dev-team/spec-critic@git:20260729.32eb18a

Pins git:20260729.32eb18a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
vmobifystudio/app-dev-team
Path
skills/spec-critic/SKILL.md
Versions recorded
2
Latest version
git:20260729.32eb18a, committed Jul 29, 2026
First version recorded
Jul 29, 2026
Size
5,999 bytes
Repository stars
5
License
MIT

Use after the impl specs and the board exist but before any developer is spawned, to find every question a developer would otherwise be forced to guess at — error types, empty/failure states, cancel paths, source of truth, units, offline, atomicity. Produces `question` rows in the team ledger for tech-lead to answer in one batch. Triggers from /app-plan and from tech-lead whenever a sprint is about to start.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Spec critic

`tech-lead` runs this. **Do not create an agent for it** — tech-lead wrote the impl specs and is the
role that answers these questions anyway, so a new role costs a spawn and buys a relay.

Run it **once per sprint**, after `docs/22-impl-spec-*.md` and `docs/31-board.md` exist and before
`/app-build` spawns anyone. Not once per ticket.

## Why it exists

Measured across three dry runs and ten agent-runs, the live team channel was used **zero times** —
including a run where the agent hit a planted ambiguity, decided it should raise it, and then
reported that it had, when it had not. An agent that can proceed will proceed. The full story is in
`skills/team-protocol/SKILL.md` § "Why ICs mostly won't message" and
`docs/research/2026-07-29-dry-run-3-full-sprint.md`.

"Declare, don't dispatch" catches the guess *after* it was made. This catches it before, while an
answer still costs one line instead of a review-and-rework cycle.

## What you hunt

For each ticket on the board, read its acceptance criteria and the spec section it points at, then
ask what a developer would have to invent. **Ground every question in an acceptance criterion — a
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add vmobifystudio/app-dev-team/spec-critic@sha256:79815f0801e889d1

The line at the top of this page pins the label git:20260729.32eb18a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fe7y6rw2izsszdby.svg)](https://markdownregistry.com/a/art_fe7y6rw2izsszdby)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, all committed on Jul 29, 2026.

versioncommittedcommitsizeaudit
git:20260729.32eb18a latest2026-07-29 32eb18a 5,999 BA view · diff
git:20260729.dc21f652026-07-29 dc21f65 5,012 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5999 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

vmobifystudio/app-dev-team · 5 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fe7y6rw2izsszdby
GET https://markdownregistry.com/api/v1/resolve?ref=vmobifystudio/app-dev-team/spec-critic
GET https://markdownregistry.com/api/v1/blob/79815f0801e889d1cdd794f2dd99a3f55b5c7850e4fa716b513713957d9ffeaa

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from vmobifystudio/app-dev-team

accessibility-gate SKILL.md skill
vmobifystudio/app-dev-team · skills/accessibility-gate/SKILL.md · Use as a pass/fail gate on any diff with a user-facing surface — by code-reviewer during review, by qa-engineer during…
git:20260729.071181e · audit A · 5 stars
agent-isolation SKILL.md skill
vmobifystudio/app-dev-team · skills/agent-isolation/SKILL.md · Use before spawning any agent that writes files, and by every developer/fixer agent as its first and last action. Gives…
git:20260807.98058c3 · audit A · 5 stars
architecture-builder SKILL.md skill
vmobifystudio/app-dev-team · skills/architecture-builder/SKILL.md · Use to produce the technical architecture doc and engineering principles for a mobile app. Used primarily by the CTO…
git:20260729.6f1f11e · audit A · 5 stars
board-doctor SKILL.md skill
vmobifystudio/app-dev-team · skills/board-doctor/SKILL.md · Use to validate docs/31-board.md before spawning any agent, and to verify a developer's "DONE" claim before moving a…
git:20260729.071181e · audit A · 5 stars
brownfield-onboarding SKILL.md skill
vmobifystudio/app-dev-team · skills/brownfield-onboarding/SKILL.md · Use when pointing the team at an EXISTING, already-built app instead of a blank project — detects the stack…
git:20260729.d5165d9 · audit A · 5 stars
business-model SKILL.md skill
vmobifystudio/app-dev-team · skills/business-model/SKILL.md · Use when deciding or revisiting how the product makes money — pricing, tiers, trial shape, ad load, unit economics — by…
git:20260729.071181e · audit A · 5 stars
content-design SKILL.md skill
vmobifystudio/app-dev-team · skills/content-design/SKILL.md · Use when writing or reviewing any string a user reads — labels, buttons, empty states, errors, permission prompts…
git:20260729.071181e · audit A · 5 stars
context-preflight SKILL.md skill
vmobifystudio/app-dev-team · skills/context-preflight/SKILL.md · Run before changing a repository to verify branch, worktree, ticket, dependencies, source-of-truth documents, and…
git:20260731.42d47b3 · audit A · 5 stars
database-migration SKILL.md skill
vmobifystudio/app-dev-team · skills/database-migration/SKILL.md · Use before changing any persisted schema — by backend-developer on a server store, by web-developer on a client or…
git:20260729.071181e · audit A · 5 stars
defect-hunting SKILL.md skill
vmobifystudio/app-dev-team · skills/defect-hunting/SKILL.md · Use when reviewing code, auditing an app, writing a guard rule or test, or certifying any threshold/constant/formula…
git:20260810.958b327 · audit A · 5 stars
dependency-policy SKILL.md skill
vmobifystudio/app-dev-team · skills/dependency-policy/SKILL.md · Audit declared dependencies, lockfiles, tool versions, compatibility, licenses, and upgrade evidence before…
git:20260731.42d47b3 · audit A · 5 stars
design-system SKILL.md skill
vmobifystudio/app-dev-team · skills/design-system/SKILL.md · Use when defining or extending design tokens and the shared component library — by product-designer when writing…
git:20260729.071181e · audit A · 5 stars

Every file in vmobifystudio/app-dev-team

Browse by kind, by grade A, or by owner.