spec SKILL.md skillA

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

Install it, pinned
mdr add surething-io/cockpit/spec@git:20261103.24ec40a

Pins git:20261103.24ec40a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
surething-io/cockpit
Path
skills/spec/SKILL.md
Versions recorded
1
Latest version
git:20261103.24ec40a, committed Nov 3, 2026
Size
6,242 bytes
Repository stars
44
License
MIT

Turn agreed requirements or a QA brief into an implementation-ready specification: behavior, contracts, boundaries, acceptance, and only the decisions that need the user. Use when asked to write or refine a SPEC, not to implement it.

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

Specification mode: make agreed intent precise enough that development and testing do not have to invent product rules. Design only as far as the work needs. No implementation.

Input: a requirement, QA result, document path, or the agreement in the current conversation. QA is useful input, not a required skill dependency.

## Workflow

1. Extract confirmed requirements and decisions from the supplied sources and conversation. Keep current behavior, requested behavior, and proposed choices distinct; never present a recommendation as an agreement.
2. Read applicable repository instructions. Inspect only the existing contracts, flows, and code needed to verify specific integration assumptions. Prefer named files and targeted searches; stop exploring once the specification has enough evidence. Cite material facts by source or path; label anything unverified.
3. Resolve contradictions using explicit user corrections and confirmed decisions. If material sources still disagree, expose the conflict as a decision rather than silently choosing. Preserve earlier decisions unless new information actually invalidates them.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add surething-io/cockpit/spec@sha256:79e29c24704f8e64

The line at the top of this page pins the label git:20261103.24ec40a, 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_dqyvbnojrwojyxb5.svg)](https://markdownregistry.com/a/art_dqyvbnojrwojyxb5)

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

Versions

The registry has recorded 1 version of this file, committed on Nov 3, 2026.

versioncommittedcommitsizeaudit
git:20261103.24ec40a latest2026-11-03 24ec40a 6,242 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 (6242 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

surething-io/cockpit · 44 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_dqyvbnojrwojyxb5
GET https://markdownregistry.com/api/v1/resolve?ref=surething-io/cockpit/spec
GET https://markdownregistry.com/api/v1/blob/79e29c24704f8e64bf631b051331a8bec7d7327416b58de09525c9a5c810dc3f

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 surething-io/cockpit

AGENTS.md AGENTS.md file
surething-io/cockpit · AGENTS.md
git:20261011.e1f2036 · audit A · 44 stars
CLAUDE.md CLAUDE.md file
surething-io/cockpit · CLAUDE.md
git:20261010.c49ded1 · audit B · 44 stars
cockpit-changelog SKILL.md skill
surething-io/cockpit · docs/skills/cockpit-changelog/SKILL.md · Draft user-facing GitHub release notes for Cockpit from a commit range, in the project's existing voice. Output is…
git:20260829.57c4561 · audit A · 44 stars
cockpit-release SKILL.md skill
surething-io/cockpit · docs/skills/cockpit-release/SKILL.md · Cut a new Cockpit release end-to-end — bump version, tag, publish to npm, write user-facing release notes, refresh the…
git:20260923.b9a5ff2 · audit A · 44 stars
bot-run SKILL.md skill
surething-io/cockpit · skills/bot-run/SKILL.md · How to run an @bot line: delegate it to its own session and wait for the result.
git:20260923.4015015 · audit A · 44 stars
bot-turn SKILL.md skill
surething-io/cockpit · skills/bot-turn/SKILL.md · How to work as a Bot for one turn: what to read, when to write, the write lock.
git:20260921.3a0ca0c · audit A · 44 stars
bot SKILL.md skill
surething-io/cockpit · skills/bot/SKILL.md · Create a Bot: a plain directory with BOT.md and long-term context, addressed as @name.
git:20260921.3a0ca0c · audit A · 44 stars
cc SKILL.md skill
surething-io/cockpit · skills/cc/SKILL.md · Drive the running Cockpit server through the `cockpit` CLI — open and control browser bubbles, observe terminals, query…
git:20260920.3dc387b · audit A · 44 stars
cg SKILL.md skill
surething-io/cockpit · skills/cg/SKILL.md · Trace code and assess change impact via the pre-built symbol, call-graph and co-edit index.
git:20260909.92d42a5 · audit A · 44 stars
cr SKILL.md skill
surething-io/cockpit · skills/cr/SKILL.md · Full code review: triangulate every change statically, model state/timing slices dynamically. Use when reviewing a PR /…
git:20260930.517a1ec · audit A · 44 stars
dl SKILL.md skill
surething-io/cockpit · skills/dl/SKILL.md · Delegate a sub-task to a new Cockpit session in any project on any engine; returns at once, or waits for the result…
git:20261011.98b5364 · audit A · 44 stars
ex SKILL.md skill
surething-io/cockpit · skills/ex/SKILL.md · Deep analysis of a complex question in one pass: answer first, then cited findings, options and open points; no code…
git:20260930.07a2bb3 · audit A · 44 stars

Every file in surething-io/cockpit

Other files named spec

spec SKILL.md skill
garrytan/gstack · spec/SKILL.md · Turn vague intent into a precise, executable spec in five phases. (gstack)
v0.1.0 · audit A · 140,694 stars
spec SKILL.md skill
snowflake-labs/cocoplus · .cortex/skills/cocobrew/spec/SKILL.md · Enter the Spec phase of CocoBrew. Guides the developer through structured requirements capture: goal, success criteria…
v1.0.4 · audit A · 728 stars
spec SKILL.md skill
atelier-fashion/adlc-toolkit · spec/SKILL.md · Write requirement specs from feature requests
git:20261030.c4e119a · audit A · 173 stars
spec SKILL.md skill
moonlight-lupin/agent-skills · plugins/dev-pipeline/skills/spec/SKILL.md · Use when pinning intent before code — capture a spec (user stories, acceptance criteria, [NEEDS CLARIFICATION]…
v2.1.0 · audit A · 119 stars
spec SKILL.md skill
kerberosclaw/kc_ai_skills · spec/SKILL.md · Use when the user wants a spec-driven development workflow for implementing a feature in the current codebase, from…
v1.10.0 · audit A · 79 stars
spec SKILL.md skill
renzrollon/interlock · skills/spec/SKILL.md · Take a rough intent to a reviewed, implementation-ready OpenSpec change — explore first, generate proposal, design…
git:20261030.e664622 · audit A · 60 stars
spec SKILL.md skill
rjmurillo/ai-agents · src/claude/skills/spec/SKILL.md · Turn a problem into testable requirements with acceptance criteria, through a first-principles gate, a memory-first…
v1.0.0 · audit A · 49 stars
spec SKILL.md skill
kriscard/skills · skills/dev/spec/SKILL.md · Builds reviewed requirements, technical design, and an executable implementation plan from an issue URL or requirements…
git:20261028.c86455e · audit A · 15 stars

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