knots-e2e

knots-e2e is a skill for Claude Code, Codex from acartine/foolery. It costs 68 tokens per session (1,235 once invoked), scanned A, original, MIT.

A workflow for carrying a Knots task from claiming through completion. Knots is a task-tracking system whose tasks can end in states such as shipped, blocked, or deferred.

In plain words
What is it for?
Use it to execute a claimed task end to end, record progress, advance its state, and stop when the task is shipped or waiting on a blocker or deferral.
Why use it?
It keeps ownership and progress consistent while an agent continues the task until it reaches a meaningful stopping point.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

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.

agentmods
npx agentmods add skills/acartine/foolery/knots-e2e
Any agent
npx skills add acartine/foolery --skill knots-e2e
Clone the repo
git clone --depth 1 https://github.com/acartine/foolery

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 knots-e2e

README.md
[![agentmods](https://agentmods.dev/badge/skills/acartine/foolery/knots-e2e.svg)](https://agentmods.dev/skills/acartine/foolery/knots-e2e)
Your own site
<a href="https://agentmods.dev/skills/acartine/foolery/knots-e2e"><img src="https://agentmods.dev/badge/skills/acartine/foolery/knots-e2e.svg" alt="Measured on agentmods" height="20"></a>
Per session 68 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,235 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.00068 $0.01235
Opus 5 $0.00034 $0.00617
Sonnet 5 $0.00014 $0.00247
Haiku 4.5 $0.00007 $0.00123

Measured 6d ago against content hash 9d7d2f918e44, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

knots-e2e 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 6d 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.

.agents/skills/knots-e2e/SKILL.md · 129 lines

How it starts

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

Knots E2E

Agent identity

Create or receive a lease before the first claim:

kno lease create --nickname "<session-name>"

Bind the same lease to every e2e claim, advance, note, and handoff-capsule command in the run. Agent identity for notes, handoff capsules, state transitions, and gate decisions comes from the bound lease.

Do not copy legacy --*-agentname/model/version identity flags from telemetry or command history. They are deprecated, ignored by current kno, and can leave metadata attributed as [unknown <date>] when no lease is bound.

Invocation precedence

When this skill is invoked, the agent MUST claim with the --e2e flag so the workflow boundary surfaced by kno advertises e2e-continuation semantics rather than the default single-action boundary:

kno claim --e2e <id> --lease <lease-id>

The claim output will then carry kind: e2e_continuation in the workflow boundary section (and "workflow_boundary_kind": "e2e_continuation" plus "e2e": true in --json output). That signal authorizes the agent to keep working past the per-claim "complete exactly one workflow action" boundary that ordinary claims emit. After every successful kno next, immediately re-claim with kno claim --e2e <id> --lease <lease-id> and continue until the knot reaches SHIPPED, BLOCKED, or DEFERRED.

If the claim output shows kind: single_action (i.e. --e2e was not passed), do NOT continue past the boundary. Stop after the single action and ask the user to re-invoke with the e2e skill if they want to continue.

Workflow

Follow this sequence:

kno claim --e2e <id> --lease <lease-id>
  • If you are working inside a git worktree, run Knots commands as kno -C <path_to_repo> ... because Knots is installed for the repo root, not the worktree path.
  • Record the current state from the claim output.
  • If the current state is SHIPPED, BLOCKED, or DEFERRED, stop cleanly.
  • Use the claim output to determine the current state's completion goals.
  • Do the work and validate it.
  • If the goals were met, advance with a guarded state check:

Read the full file on GitHub · 129 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. 6d ago First seen · 129 lines · 68 tokens per session scan A 9d7d2f918e44

Subscribe to this mod's changes

knots-e2e is a skill published in the GitHub repository acartine/foolery (54 stars, last pushed 1mo ago), licensed MIT. It adds 68 tokens to every session and 1,235 once invoked, about $0.0003 per session on Opus 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-08-30.

Related

Other skills, from other repositories

write-documentation

Use when writing or substantially rewriting human-facing prose: documentation, README, guides, blog posts, emails, Slack messages, PR descriptions, release notes, or any text a human will read. Not for code comments, commit messages, or agent-to-agent communication.

DollarDill/beads-superpowers · 56 tokens

document-release

Use when implementation on a branch is complete and it is about to be merged or PR'd — or when finishing-a-development-branch reaches its docs-audit gate — and after code changes are committed, to ensure all project documentation accurately reflects shipped code. Covers README, ARCHITECTURE, CONTRIBUTING, CHANGELOG…

DollarDill/beads-superpowers · 103 tokens

stress-test

Use when a design, plan, or decision needs adversarial scrutiny before proceeding. Interrogates every branch of the decision tree, providing recommended answers and forcing explicit agreement or pushback. Triggers on "grill me", "stress test this", "poke holes", "challenge this design", or when…

DollarDill/beads-superpowers · 72 tokens

systematic-debugging

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

DollarDill/beads-superpowers · 21 tokens

writing-plans

Use when you have a spec or requirements for a multi-step task, before touching code.

DollarDill/beads-superpowers · 21 tokens

getting-up-to-speed

Orients on an unfamiliar or stale codebase at the start of a session, after compaction, or whenever the project state is unclear. Loads beads context, deep-dives the codebase, and produces a structured 'current state' summary. Triggers on phrases like "catch me up", "where are we", "orient me", "what's the state of…

DollarDill/beads-superpowers · 97 tokens