agtx-oneshot

agtx-oneshot is a skill for Claude Code from fynnfluegge/agtx. It costs 51 tokens per session (3,770 once invoked), scanned A, original, Apache-2.0.

A project-running workflow for an agtx kanban board, where work moves through Backlog, Planning, Running, Review, and Done. It coordinates tasks and workers until the project is merged.

In plain words
What is it for?
It helps run a large project unattended on an active agtx board, from task decomposition through review and merging.
Why use it?
It removes the need for a person to manually break down tasks, start work, unblock workers, review results, and merge each task.

Skill for Claude Code

Written for Claude Code: disable-model-invocation in frontmatter.

Part of the agtx plugin — 8 skills, 1 command, 1 MCP server shipped together

Good fit It helps run a large project unattended on an active agtx board, from task decomposition through review and merging.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/fynnfluegge/agtx/oneshot
About the project

agtx is a terminal-based shared workspace where multiple coding agents coordinate through a task board. Developers use it to delegate work, run agents in parallel across git worktrees, and move tasks through different workflow phases.

fynnfluegge/agtx · 1,715 stars · on GitHub

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 fynnfluegge/agtx --skill oneshot
Clone the repo
git clone --depth 1 https://github.com/fynnfluegge/agtx

Made for: Claude Code.

Or install agtx, the plugin that ships this one along with the rest of its 8 skills, 1 command, 1 MCP server.

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 agtx-oneshot

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

Your own site · 80×15
<a href="https://agentmods.dev/skills/fynnfluegge/agtx/oneshot"><img src="https://agentmods.dev/badge/skills/fynnfluegge/agtx/oneshot.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 51 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,770 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 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.00051 $0.03770
Opus 5.5 $0.00020 $0.01508
Sonnet 5.5 $0.00010 $0.00754
Haiku 4.5 $0.00005 $0.00377

Measured 1mo ago against content hash 9244bf979802, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

agtx-oneshot 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 1mo 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.

skills/oneshot/SKILL.md · 289 lines

How it starts

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

agtx — One-Shotting a Project

You are one-shotting a project on an agtx kanban board: a goal too large for one session, run to completion unattended. Ordinarily a person sits at the board and does this. Here, you are that person.

This is not the built-in orchestrator (O), which only advances Planning → Running → Review and refuses to touch Backlog. You own all five columns: you decompose the goal into tasks, decide what starts, watch the workers, unblock them, judge Review, and merge. The workers do the coding; you never write feature code yourself.

Backlog → Planning → Running → Review → Done
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
              all of it is yours

Before anything else: verify the board is live

Nothing you do executes unless the agtx TUI is running. move_task writes a row to a queue; the TUI drains it and performs the real work — worktree creation, agent spawn, skill deployment. With no TUI, every transition sits pending forever and the board looks frozen for no visible reason.

  1. Call list_projects and take the project_id of this project; pass it to every other agtx tool. If the MCP server does not answer, tell the user to register it and stop:
    claude mcp add --scope user agtx -- agtx mcp-serve
    
    If this project is not listed, it has never been opened in agtx — ask the user to run agtx in the project root, which is needed anyway (below). Then call list_tasks.
  2. Check tui_connected in that response. If it is false, no TUI is draining the queue — ask the user to open agtx in another terminal on this project, and do not queue anything into a dead board.

Also confirm before a long unattended run:

  • Call get_config and check auto_trust. It must be true, or agents' trust and bypass-permission dialogs are detected but left unanswered and every task parks as Blocked waiting for a human who is not there. Use the tool — do not read ~/.config/agtx/config.toml yourself: AGTX_CONFIG_DIR relocates that file, so the path is not authoritative and you will get a stale answer. get_config also tells you which file to edit. auto_trust is global-only, so a project config cannot turn it on.
  • Open the coding agent once in the project root and accept its trust prompt before starting. Your own session parks on that dialog in a directory the agent has not seen, and an unattended run has nobody to answer it.
  • The project has a base branch and a clean tree.

Read the full file on GitHub · 289 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. 1mo ago First seen · 289 lines · 51 tokens per session scan A 9244bf979802

Subscribe to this mod's changes

agtx-oneshot is a skill published in the GitHub repository fynnfluegge/agtx (1,715 stars, last pushed 14d ago), licensed Apache-2.0. It adds 51 tokens to every session and 3,770 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-14.