mate-backfill-spec

mate-backfill-spec is a skill for Claude Code from uniqbit-ag/mate-cli. It costs 52 tokens per session (1,503 once invoked), scanned A, original, MIT.

A guided workflow for documenting one existing software feature in an OpenSpec specification. It examines the code and tests, asks about unclear behavior, and writes the approved result to the project's canonical spec file.

In plain words
What is it for?
Use it to backfill a specification for one feature that has no accurate spec yet, especially when the behavior is spread across code and tests.
Why use it?
It records how legacy or already-shipped behavior works without creating a new implementation change. User review helps prevent guesses and unconfirmed bugs from becoming documentation.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Good fit Use it to backfill a specification for one feature that has no accurate spec yet, especially when the behavior is spread across code and tests.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/uniqbit-ag/mate-cli/mate-backfill-spec
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.

Any agent
npx skills add uniqbit-ag/mate-cli --skill mate-backfill-spec
Clone the repo
git clone --depth 1 https://github.com/uniqbit-ag/mate-cli

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mate-backfill-spec

README.md
[![agentmods](https://agentmods.dev/badge/skills/uniqbit-ag/mate-cli/mate-backfill-spec/github.svg)](https://agentmods.dev/skills/uniqbit-ag/mate-cli/mate-backfill-spec)
Your own site
<a href="https://agentmods.dev/skills/uniqbit-ag/mate-cli/mate-backfill-spec"><img src="https://agentmods.dev/badge/skills/uniqbit-ag/mate-cli/mate-backfill-spec/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for mate-backfill-spec

Your own site · 80×15
<a href="https://agentmods.dev/skills/uniqbit-ag/mate-cli/mate-backfill-spec"><img src="https://agentmods.dev/badge/skills/uniqbit-ag/mate-cli/mate-backfill-spec.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 52 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,503 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00052 $0.01503
Opus 5.5 $0.00021 $0.00601
Sonnet 5.5 $0.00010 $0.00301
Haiku 4.5 $0.00005 $0.00150

Measured today against content hash 800770efbe7c, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

mate-backfill-spec scanned grade A with 1 finding 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 today.

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.

Runs shell commandslowCapability

Expected in a hook, worth knowing in a rule or an instructions file.

In both cases every requirement you write carries each per-requirement marker the schema requires (for example an `**Area:**` marker whose value appears in the spec's frontmatter). Requirements state observable contracts
packages/mate-core/src/templates/mate-skills/agents/mate-backfill-spec/SKILL.md · 84 lines

How it starts

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

Mate OpenSpec Backfill

Specify one feature that already exists in the working repository. A backfill records behavior that already shipped, so the run writes the canonical spec openspec/specs/<capability>/spec.md directly and leaves it uncommitted. It never creates a change and never publishes; publication happens afterwards through mate-publish-artifact.

Scope rules

  • One named feature per run. Refuse Area-wide or repository-wide sweeps; ask the user to name a single feature and run the skill once per feature.
  • Interactive by design. Every ambiguity and every suspected bug becomes a user question, and nothing is written before the user approves the review table. Do not run this skill unattended.

Steps

  1. Scope. Map the named feature to code: entry points, callees, tests. Use whatever exploration tooling this project has enabled (code-graph or index tools when present, otherwise search and targeted reading) — assume no specific capability is installed. Then check openspec/specs/ for an existing capability covering this domain — prefer extending it in place over minting a new capability id.

  2. Sweep. Extract candidate behaviors and tag each finding:

    • [test-backed] — an existing test verifies it (strongest; scenarios translate almost directly from tests)
    • [code-only] — observable in code but untested
    • [inferred] — assumed intent without direct evidence

    Every candidate requirement needs at least one citation: a test name or file:line. Docs and comments corroborate but never stand alone. [inferred] findings are not requirements — they become questions for step 3.

  3. Ask. Batch the open questions to the user:

    • Behavior that looks unintended → the user rules spec the actual behavior or spec the intent (and the user may open a separate fix change). Suspected bugs never silently become requirements.
    • [inferred] findings → confirm, demote to out-of-scope, or drop.
  4. Review. Before writing any file, present every drafted requirement in one table and wait for the user's approval:

Read the full file on GitHub · 84 lines

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. today First seen · 84 lines · 52 tokens per session scan A 800770efbe7c

Subscribe to this mod's changes

mate-backfill-spec is a skill published in the GitHub repository uniqbit-ag/mate-cli (12 stars, last pushed today), licensed MIT. It adds 52 tokens to every session and 1,503 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 1 finding (runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-30.

Related

Other skills, from other repositories

local-ai-agents

Build local-first AI agents that run entirely on a developer workstation with Microsoft Foundry Local and Qwen function-calling models. Covers Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG with Chroma, local MCP servers, hybrid cloud/local routing, and the…

microsoft/ai-agents-for-beginners · 200 tokens

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

next-cache-components-adoption

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…

vercel/next.js · 95 tokens

chat-pet-sprite-creation

Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.

microsoft/vscode · 53 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens

insight-error-page

Write or audit an insight-kind error page for the Next.js dev overlay. Use when creating a new errors/ .mdx page, auditing an existing one, or checking that a page matches the framework fix cards. Covers page structure, title alignment, FixCard cards with Copy prompt button, code snippets, terminology verification…

vercel/next.js · 83 tokens