bitbottle: Skill for Claude Code

.agents/skills/implement-spec/SKILL.md

implement-spec is a skill for Claude Code, Codex from proggarapsody/bitbottle. It costs 18 tokens per session (591 once invoked), scanned A, a copy of implement-spec, MIT.

A workflow for implementing a written specification and its related tickets in code. It treats tickets as a task graph, meaning some tasks become ready only after the tasks they depend on are complete.

In plain words
What is it for?
Use it to implement a complete specification across its tickets on one integration branch. It can coordinate code changes, exploration, and ticket completion when the repository has the required issue-tracker setup.
Why use it?
It prevents implementation from drifting away from the agreed specification and helps order work with dependencies. It also keeps communication centred on shared documents and saved notes.

Skill for Claude CodeCodex

Written for Claude Code and Codex: disable-model-invocation in frontmatter, but also agents/openai.yaml present. Also seen: mentions subagents; installed under .agents/ (shared by several agents).

This is proggarapsody/bitbottle's own configuration. It tells Claude Code and Codex how to work on bitbottle itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything bitbottle configures →

Reuse

Borrowing it

Nothing to install: this file belongs to proggarapsody/bitbottle. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/proggarapsody/bitbottle/main/.agents/skills/implement-spec/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/proggarapsody/bitbottle

Made for: Claude Code, Codex.

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 implement-spec

README.md
[![agentmods](https://agentmods.dev/badge/skills/proggarapsody/bitbottle/implement-spec/github.svg)](https://agentmods.dev/skills/proggarapsody/bitbottle/implement-spec)
Your own site
<a href="https://agentmods.dev/skills/proggarapsody/bitbottle/implement-spec"><img src="https://agentmods.dev/badge/skills/proggarapsody/bitbottle/implement-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 implement-spec

Your own site · 80×15
<a href="https://agentmods.dev/skills/proggarapsody/bitbottle/implement-spec"><img src="https://agentmods.dev/badge/skills/proggarapsody/bitbottle/implement-spec.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 18 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 591 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 100% copy Near-identical to another mod 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.00018 $0.00591
Opus 5.5 $0.00007 $0.00236
Sonnet 5.5 $0.00004 $0.00118
Haiku 4.5 $0.00002 $0.00059

Measured 9d ago against content hash 7a22dd2e60b8, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

implement-spec scanned grade A with 0 findings 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 9d ago.

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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to implement-spec — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.agents/skills/implement-spec/SKILL.md · 41 lines

What it actually says

You have been provided a spec. This spec should have tickets associated with it, describing how to implement the spec.

The issue tracker should have been provided to you. If not, tell the user to run /setup-matt-pocock-skills.

The goal is the entire spec implemented on a single integration branch, with every ticket resolved the way the issue tracker closes work.

The tickets are not a list of steps. They are a task graph with blocking relationships between them. This means there is always a frontier of tickets which are ready to be grabbed.

Communication to and from subagents should be sparse. Communicate primarily through context pointers: to the spec, tickets, research notes, and previous commits. Don't duplicate information already available via pointers.

Implementer subagents should be run in the background where possible for maximum concurrency.

Steps

  1. Read the spec and tickets to understand the task graph.

  2. (optional) Use an exploration subagent to conduct any exploration required by the tickets - relevant codebase files or external documentation. Ensure the exploration subagent can save files - it should save its markdown notes in a directory outside the repo, accessible by all future subagents. This lets implementer subagents focus on implementation rather than exploration.

  3. Create the integration branch. If the issue tracker closes work through PRs, or the user asks for one, open a draft PR after the first merge in step 5 (a branch with no commits ahead of main can't open one), marked as closing the spec and tickets.

  4. Use implementer subagents to implement each ticket, each in its own worktree on its own branch. Each implementer subagent:

    • confirms its worktree is based on the integration branch before starting, and resets onto it if not;
    • calls the Skill tool with tdd to build the ticket;
    • merges the integration branch tip into its own branch before reporting done
  5. Once an implementer subagent completes, merge its work to the integration branch with a merger subagent.

  6. If this changes the frontier of available tickets, kick off more implementer subagents to work on the new tickets. This allows for maximum concurrency.

  7. Once all tickets are complete, call the Skill tool with code-review on the integration branch. Fix all issues raised by the code review in a single implementer subagent.

  8. If a draft PR exists, mark it ready for review. Otherwise, resolve each ticket the way the issue tracker closes work, and report the integration branch.

  9. Clean up all implementer subagent worktrees.

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 9d ago First seen · 41 lines · 18 tokens per session scan A 7a22dd2e60b8

Subscribe to this mod's changes

implement-spec is a skill published in the GitHub repository proggarapsody/bitbottle (3 stars, last pushed 7d ago), licensed MIT. It adds 18 tokens to every session and 591 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. It is 100% identical to implement-spec, differing in 0 lines, and is treated as a copy.

Related

Other skills, from other repositories

deploy-setup

Wire up a freshly scaffolded Starter Series project for its first release — detect the template, register required GitHub secrets, set up OIDC trusted publishing where applicable, and trigger the first CD run. Pairs with the create skill (you scaffold first, then run this).

starter-series/create-starter · 61 tokens

team-conventions

The conventions this team actually follows — naming, branching, review, and the decisions someone already made so nobody re-litigates them. Use when writing or reviewing code here, opening a PR, or when unsure "how do we do this".

runbear-io/beardrive · 53 tokens

session-repo

Restart this Claude session inside the git repository it is working on, keeping the conversation. Use when a remote (crctl / screen) session was started outside its repo - e.g. in the home directory - so the Claude apps show no branch, diff or pull request for it; or when the user asks to restart this session, move…

pigri/code-remote · 98 tokens

glab

GitLab workflow automation using glab CLI.

JustineDevs/premortem · 11 tokens

insecure-source-code-management

Source control and artifact exposure (.git, .svn, .hg, backups, .env). Use when recon finds VCS paths, 403 on hidden dirs, or backup/config leaks during authorized testing.

JustineDevs/premortem · 47 tokens

setup-pre-commit

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

JustineDevs/premortem · 62 tokens