roasting-the-spec SKILL.md skillA

roasting-the-spec from jjuraszek/pi-gauntlet is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jjuraszek/pi-gauntlet/roasting-the-spec@git:20261020.c79e361

Pins git:20261020.c79e361 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jjuraszek/pi-gauntlet
Path
skills/roasting-the-spec/SKILL.md
Versions recorded
12
Latest version
git:20261020.c79e361, committed Oct 20, 2026
First version recorded
Sep 7, 2026
Size
18,565 bytes
Repository stars
19
License
a license file GitHub does not identify

Use after writing a spec when the resolved piGauntlet.specCouncil members list is non-empty. Auto-dispatched by /skill:brainstorming as its configured critique pass with a fresh-context applier executor before the spec review gate.

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

# Roasting the Spec (Spec Council)

## Overview

Run a multi-model critique pass for a freshly written spec. Each council **member** runs on a different model and critiques independently; the neutral **chair** consolidates and adjudicates disagreements. Dispatch a fresh-context **applier** inheriting the main loop's model and thinking to decide dispositions and edit the spec, returning only the audit. Hand the result to the **user** to ratify (or revert) at brainstorming's single gate.

Auto-dispatched from `/skill:brainstorming` as the critique pass, after the inline lint and before the user review gate, **only when a council is configured** (`members` non-empty). brainstorming owns that gate; when no council is configured it runs a single fresh-`worker` critique instead and does not invoke this skill.

## Hard constraint

This skill may read anything and edit **only** the spec under `doc/specs/`. It does not write code, does not run implementation skills, and does not land anything on `main`. Applied edits ride in the same worktree spec commit as the rest of brainstorming's output.

## Separation of powers
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jjuraszek/pi-gauntlet/roasting-the-spec@sha256:a9660d8724728b55

The line at the top of this page pins the label git:20261020.c79e361, 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_2mnqynsom56hqckv.svg)](https://markdownregistry.com/a/art_2mnqynsom56hqckv)

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

Versions

The registry has recorded 12 versions of this file, between Sep 7, 2026 and Oct 20, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20261020.c79e361 latest2026-10-20 c79e361 18,565 BA view · diff
git:20261019.d9ee3872026-10-19 d9ee387 18,391 BA view · diff
git:20261019.0a6ab582026-10-19 0a6ab58 18,671 BA view · diff
git:20261017.836bbce2026-10-17 836bbce 17,673 BA view · diff
git:20261006.909c6102026-10-06 909c610 17,393 BA view · diff
git:20261004.71685552026-10-04 7168555 17,255 BA view · diff
git:20260926.47d86012026-09-26 47d8601 17,009 BA view · diff
git:20260923.88370ec2026-09-23 88370ec 16,551 BA view · diff
git:20260923.88da0de2026-09-23 88da0de 16,396 BA view · diff
git:20260918.311fca72026-09-18 311fca7 15,671 BA view · diff
git:20260917.5fd185d2026-09-17 5fd185d 14,112 BA view · diff
git:20260907.d42a1b52026-09-07 d42a1b5 14,119 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 (18565 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

jjuraszek/pi-gauntlet · 19 stars · license a license file GitHub does not identify · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_2mnqynsom56hqckv
GET https://markdownregistry.com/api/v1/resolve?ref=jjuraszek/pi-gauntlet/roasting-the-spec
GET https://markdownregistry.com/api/v1/blob/a9660d8724728b55338ec9ea823bf375ed194ba7228d4eb31716aafaf8a30dfb

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 jjuraszek/pi-gauntlet

release SKILL.md skill
jjuraszek/pi-gauntlet · .agents/skills/release/SKILL.md · Use when asked to release, publish, bump the version, or cut a tag for jjuraszek/pi-gauntlet.
git:20261020.c79e361 · audit A · 19 stars
AGENTS.md AGENTS.md file
jjuraszek/pi-gauntlet · AGENTS.md
git:20261020.c79e361 · audit A · 19 stars
AGENTS.md@eval/forge-skill/samples/history-section-cleanup/fixture AGENTS.md file
jjuraszek/pi-gauntlet · eval/forge-skill/samples/history-section-cleanup/fixture/AGENTS.md
git:20261018.dc0a360 · audit B · 19 stars
release-notes SKILL.md skill
jjuraszek/pi-gauntlet · eval/forge-skill/samples/minimal-diff-one-line/fixture/SKILL.md · Use when asked to draft release notes from a merged changelog section.
git:20261007.500497b · audit A · 19 stars
audit-runbook SKILL.md skill
jjuraszek/pi-gauntlet · eval/forge-skill/samples/oversized-skill-extraction/fixture/SKILL.md · Use when asked to audit a service deployment against the twelve runbook sections.
git:20261007.500497b · audit A · 19 stars
answer-question SKILL.md skill
jjuraszek/pi-gauntlet · eval/forge-skill/samples/prohibition-to-recipe/fixture/SKILL.md · Use when the user asks a factual question about the codebase and wants a direct answer.
git:20261007.500497b · audit A · 19 stars
pr-checklist SKILL.md skill
jjuraszek/pi-gauntlet · eval/forge-skill/samples/reference-file-edit/fixture/SKILL.md · Use before opening a pull request to run the project's pre-merge checks.
git:20261007.500497b · audit A · 19 stars
AGENTS.md@eval/forge-skill/samples/untouched-history-stays/fixture AGENTS.md file
jjuraszek/pi-gauntlet · eval/forge-skill/samples/untouched-history-stays/fixture/AGENTS.md
git:20261018.dc0a360 · audit B · 19 stars
brainstorming SKILL.md skill
jjuraszek/pi-gauntlet · skills/brainstorming/SKILL.md · Use only when the user explicitly requests brainstorming or selects a handoff into it.
git:20261020.c79e361 · audit A · 19 stars
chase-bug SKILL.md skill
jjuraszek/pi-gauntlet · skills/chase-bug/SKILL.md · Use when a human hands you a bug report to triage - a Slack paste, tracker ticket, GitHub issue, or described symptom -…
git:20261020.c79e361 · audit A · 19 stars
check-delivery SKILL.md skill
jjuraszek/pi-gauntlet · skills/check-delivery/SKILL.md · Use only when explicitly asked to prove delivery of a named merged ticket ("check delivery of ABC-123", a loop task…
git:20261020.c79e361 · audit A · 19 stars
dispatching-parallel-agents SKILL.md skill
jjuraszek/pi-gauntlet · skills/dispatching-parallel-agents/SKILL.md · Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies, when…
git:20261020.c79e361 · audit A · 19 stars

Every file in jjuraszek/pi-gauntlet

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