spec-author SKILL.md skillA

This file is byte-identical to the first copy the registry indexed, one of 3 indexed copies. Same content hash, so the same checks give both the same grade.

spec-author from crewrig/crewrig is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add crewrig/crewrig/spec-author@git:20261023.36e317a

Pins git:20261023.36e317a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
crewrig/crewrig
Path
.agents/skills/spec-author/SKILL.md
Versions recorded
5
Latest version
git:20261023.36e317a, committed Oct 23, 2026
First version recorded
Sep 26, 2026
Size
7,694 bytes
Repository stars
24
License
Apache-2.0

Specification authoring for the SPECS stage of the ADR-0010 lifecycle. Activate as step 0 of any non-trivial ticket, before architect, developer or tester, to qualify the intent and emit one spec under `/specs/` per `docs/spec-format.md`. Mode-aware (FULL/INTERMEDIATE/MINIMAL/AUTO).

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 Author

The `spec-author` skill turns a raw user intent into a draft specification
file under `/specs/` conforming to `docs/spec-format.md`. It owns the
*qualification* phase of the ADR-0010 lifecycle — answering "what does the
user actually want" — and emits exactly one artifact: a Markdown spec file.
It does not plan, design, or implement; those belong to downstream skills.

The skill is mode-aware (FULL / INTERMEDIATE / MINIMAL / AUTO per ADR-0010
→ *Interaction modes*) and adjusts interview depth accordingly. AUTO
authors the spec end-to-end with zero questions; the other three modes
escalate user gating.

## When to activate

1. **Explicit user invocation.** The user types `/spec` (or the equivalent
   CLI activation phrase). Optional flags: `--mode=FULL|INTERMEDIATE|MINIMAL|AUTO`,
   `--issue=<number>`. Absent `--issue`, the skill infers the parent ticket
   from the current context.
2. **Orchestrator routing of a fresh ticket.** Any new ticket whose tier
   is not `trivial` (per ADR-0010 → *Complexity tiers*) routes through
   `spec-author` before any other team role. Trivial tickets bypass — the
   orchestrator handles them inline.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add crewrig/crewrig/spec-author@sha256:8a550d14019c57a3

The line at the top of this page pins the label git:20261023.36e317a, 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_jdigoii6h5txnigq.svg)](https://markdownregistry.com/a/art_jdigoii6h5txnigq)

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

Versions

The registry has recorded 5 versions of this file, between Sep 26, 2026 and Oct 23, 2026, about one every 7 days.

versioncommittedcommitsizeaudit
git:20261023.36e317a latest2026-10-23 36e317a 7,694 BA view · diff
git:20261018.1588e622026-10-18 1588e62 7,694 BA view · diff
git:20261018.d2509882026-10-18 d250988 30,644 BA view · diff
git:20261001.0eab7492026-10-01 0eab749 30,597 BA view · diff
git:20260926.5e0248f2026-09-26 5e0248f 29,415 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 (7694 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

crewrig/crewrig · 24 stars · license Apache-2.0 · pushed 2026-10-25 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jdigoii6h5txnigq
GET https://markdownregistry.com/api/v1/resolve?ref=crewrig/crewrig/spec-author
GET https://markdownregistry.com/api/v1/blob/8a550d14019c57a3a40ab21de788d9238e6c6cc678fa9ad7bb415f67e4ee57f0

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 crewrig/crewrig

architect SKILL.md skill
crewrig/crewrig · .agents/skills/architect/SKILL.md · Design and architecture skill for ADRs, RFCs, design reviews, and ripple-effect analysis. Activate when a change…
git:20261020.22def2d · audit A · 24 stars
astro SKILL.md skill
crewrig/crewrig · .agents/skills/astro/SKILL.md · Practitioner-grade Astro reference: syntax, islands, routing, Content Collections, SSG/SSR, integrations (Tailwind…
git:20261018.1588e62 · audit B · 24 stars
copywriting SKILL.md skill
crewrig/crewrig · .agents/skills/copywriting/SKILL.md · Practitioner-grade web copywriting reference: landing page anatomy, frameworks (PAS, BAB, AIDA), tone, headlines, CTAs…
git:20261018.1588e62 · audit A · 24 stars
developer SKILL.md skill
crewrig/crewrig · .agents/skills/developer/SKILL.md · Implementation skill for writing, modifying, and refactoring code. Activate by default for any coding task that does…
git:20261018.1588e62 · audit A · 24 stars
doc-writer SKILL.md skill
crewrig/crewrig · .agents/skills/doc-writer/SKILL.md · Documentation skill for ADRs, READMEs, in-code docstrings, and reference material. Activate when the user asks for…
git:20260620.d7282ed · audit A · 24 stars
frontend SKILL.md skill
crewrig/crewrig · .agents/skills/frontend/SKILL.md · Practitioner-grade frontend reference: HTML semantics, CSS tokens, Tailwind, WCAG 2.1 AA, Core Web Vitals, asset…
git:20261018.1588e62 · audit B · 24 stars
github-actions SKILL.md skill
crewrig/crewrig · .agents/skills/github-actions/SKILL.md · Practitioner-grade GitHub Actions knowledge: authoring, reviewing, hardening, debugging workflows. Activate when…
git:20261018.1588e62 · audit A · 24 stars
gitlab-ci SKILL.md skill
crewrig/crewrig · .agents/skills/gitlab-ci/SKILL.md · Practitioner-grade GitLab CI/CD knowledge: authoring, reviewing, hardening, debugging pipelines. Activate when reading…
git:20261018.1588e62 · audit A · 24 stars
idea SKILL.md skill
crewrig/crewrig · .agents/skills/idea/SKILL.md · IDEA stage lifecycle skill for structured idea-convergence. Activate before a SPECS session whenever multiple…
git:20260926.ddddb55 · audit A · 24 stars
init-expertise SKILL.md skill
crewrig/crewrig · .agents/skills/init-expertise/SKILL.md · Create a new expertise (role) file under config/expertise/ through a guided interview. Activate when an adopter wants a…
git:20261018.1588e62 · audit A · 24 stars
init-personal-profile SKILL.md skill
crewrig/crewrig · .agents/skills/init-personal-profile/SKILL.md · Build your personal profile (config/PROFILE.md) through a guided interview. Collects identity, tooling preferences…
git:20260828.841e5e1 · audit A · 24 stars
init-soul SKILL.md skill
crewrig/crewrig · .agents/skills/init-soul/SKILL.md · Customize the agent identity file (config/SOUL.md) through guided conversation. Walk the user through each section of…
git:20260828.841e5e1 · audit A · 24 stars

Every file in crewrig/crewrig

Other files named spec-author

spec-author SKILL.md skill
llopresto87/cypress · skills/spec-author/SKILL.md · Write an executable specification under docs/graph/specs/ that turns a clear goal into testable contracts. Use whenever…
git:20261006.fa6eac5 · audit A · 119 stars
spec-author SKILL.md skill
crewrig/crewrig · .github/skills/spec-author/SKILL.md · Specification authoring for the SPECS stage of the ADR-0010 lifecycle. Activate as step 0 of any non-trivial ticket…
git:20261023.36e317a · audit A · 24 stars
spec-author SKILL.md skill
crewrig/crewrig · .gemini/skills/spec-author/SKILL.md · Specification authoring for the SPECS stage of the ADR-0010 lifecycle. Activate as step 0 of any non-trivial ticket…
git:20261023.36e317a · audit A · 24 stars
spec-author SKILL.md skill
crewrig/crewrig · .claude/skills/spec-author/SKILL.md · Specification authoring for the SPECS stage of the ADR-0010 lifecycle. Activate as step 0 of any non-trivial ticket…
git:20261023.36e317a · audit A · 24 stars

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