sw-do

sw-do is a skill for Claude Code from anton-abyzov/specweave. It costs 46 tokens per session (1,910 once invoked), scanned A, original, MIT.

A task-by-task implementation workflow for SpecWeave increments, which are documented units of work with a specification, acceptance criteria, and task list. It records evidence for each completed task and verifies the final close.

In plain words
What is it for?
Use it to choose the next available task, claim its files, read the applicable requirements, implement the change, run proof checks, and close the increment.
Why use it?
It keeps implementation tied to the agreed requirements and prevents agents from editing files before claiming the relevant task. It also leaves a test result or commit reference for completed work.

Skill for Claude Code

Written for Claude Code: argument-hint in frontmatter. Also seen: mentions Codex.

Good fit Use it to choose the next available task, claim its files, read the applicable requirements, implement the change, run proof checks, and close the increment.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/anton-abyzov/specweave/sw-do
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 anton-abyzov/specweave --skill sw-do
Clone the repo
git clone --depth 1 https://github.com/anton-abyzov/specweave

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 sw-do

README.md
[![agentmods](https://agentmods.dev/badge/skills/anton-abyzov/specweave/sw-do/github.svg)](https://agentmods.dev/skills/anton-abyzov/specweave/sw-do)
Your own site
<a href="https://agentmods.dev/skills/anton-abyzov/specweave/sw-do"><img src="https://agentmods.dev/badge/skills/anton-abyzov/specweave/sw-do/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 sw-do

Your own site · 80×15
<a href="https://agentmods.dev/skills/anton-abyzov/specweave/sw-do"><img src="https://agentmods.dev/badge/skills/anton-abyzov/specweave/sw-do.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 46 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,910 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. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
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.00046 $0.01910
Opus 5.5 $0.00018 $0.00764
Sonnet 5.5 $0.00009 $0.00382
Haiku 4.5 $0.00005 $0.00191

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

Security

Grade A, and why

sw-do 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 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.

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.

skills/sw-do/SKILL.md · 123 lines

How it starts

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

sw-do: work an increment to done

Tasks are defined in spec.md under ## Tasks; their state lives only in the increment's ledger.jsonl, which the CLI appends to. Never write state into spec.md.

Start

specweave pickup applies any handoff pushed from another tool or account, then prints the open increment, the next task with its acceptance criteria, claims other agents hold, and notes left for you. No increment yet? Run sw-increment first.

The loop

  1. specweave task next prints the next claimable task with its AC text.
  2. specweave task claim T-03 --line "Writing the ledger fold". Exit 3: someone holds it (your own earlier claim from a crashed session: say so, then --force); 4: its Files overlap a live claim; 6: its dependencies are not done. Otherwise pick another. Never edit before claiming.
  3. Implement inside that task's Files only. Need another file? Claim the task that owns it, or add a task to spec.md ## Tasks. Use the words in GLOSSARY.md, if the project has one, for every new name.
  4. Run the task's Test. Red means fix the code; never skip, weaken or delete a test. Don't write tests first or add unit tests the task did not ask for (unless the project's testing config or conventions require them): check the AC end to end, the way a user would hit it.
  5. Commit with the increment id first: git commit -m "0042: fold the ledger".
  6. specweave task done T-03 --run "npm run test:e2e -- double-claim" --line "Wrote the ledger fold" --link <PR URL>. Exit 5: the command failed and the task stays open. No Test? --evidence "<sha> + what you checked". --line is the card text (one line, past tense when done, at most 100 characters); --link is the PR, report or artifact behind it.
  7. Stuck: specweave task block T-03 --reason "<what is missing>". Not needed: specweave task skip T-03 --reason "<why>". Then back to 1.

Commands take the increment id last (specweave task next 0042) when more than one increment is active. specweave task list shows the whole board. For a status, print specweave cards --md: one ✓ / ✱ / ○ text (link) line per task. Work with no increment: specweave card add "<text>", then card start|done|wait C-01.

Read the full file on GitHub · 123 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 Changed b71472703fec
  2. 4d ago Changed · +11 lines 279697469ba4
  3. 6d ago Changed · +36 lines · +2 tokens per session 007ae8ddc901
  4. 12d ago Changed · +3 lines ee07583e8034
  5. 28d ago Changed · -6 lines · +3 tokens per session 677da45579c1
  6. 1mo ago First seen · 79 lines · 41 tokens per session scan A 8588907f8122

Subscribe to this mod's changes

sw-do is a skill published in the GitHub repository anton-abyzov/specweave (167 stars, last pushed today), licensed MIT. It adds 46 tokens to every session and 1,910 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.