New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

agtx Task Planning

by fynnfluegge in fynnfluegge/agtx

Analyzes the codebase for an agtx task, writes a plan with analysis, steps and risks to .agtx/plan.md, then stops and waits for approval before any change.

Apache-2.0Auto-check passedAgent Workflows

Install agtx Task Planning

skills CLI
$ npx skills add fynnfluegge/agtx --skill agtx-plan -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install fynnfluegge/agtx agtx-plan --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/fynnfluegge/agtx.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/agtx-terse/skills/agtx-plan .claude/skills/agtx-plan && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
agtx-plan
GitHub stars
1.7k
Token cost
~439 tokens
SKILL.md length
215 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

Analyzes the codebase for an agtx task, writes a plan with analysis, steps and risks to .agtx/plan.md, then stops and waits for approval before any change.

  • Works in 5 steps: Fetch the task description via get_task → If .agtx/research.md exists, read it for… → Explore the codebase to understand… → …
  • Planning a task from the agtx board before any code changes
  • SKILL.md covers Input, Instructions, Output and Analysis, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

In the planning phase of an agtx-managed task, the agent fetches the task description by ID through the agtx MCP get_task tool and reads .agtx/research.md if an earlier research phase produced it. It then explores the codebase for relevant files, patterns and architecture, and lists everything that must be created or modified.

The plan goes to .agtx/plan.md in the current directory with three sections: Analysis, Plan (ordered steps, files and approach) and Risks (edge cases and breaking changes). Afterward the agent must not start implementing or touch source files; it states that the plan is written and waits for explicit approval. Replies are kept terse, with fragments allowed and one-line status updates.

When your agent uses it

  • Planning a task from the agtx board before any code changes
  • Producing a reviewable implementation plan with its risks listed
  • Following up a research phase with a concrete plan

Example prompts

  • “Plan the agtx task I just selected and write it to .agtx/plan.md.”
  • “Read the research notes and draft the implementation plan, then wait for my approval.”
  • “Make a plan for this agtx task, with no code changes until I approve.”

Requirements

  • The agtx MCP server for fetching task descriptions

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Fetch the task description via get_task
  2. If .agtx/research.md exists, read it for prior analysis
  3. Explore the codebase to understand relevant files, patterns, and architecture
  4. Identify all files that need to be created or modified
  5. Create a detailed implementation plan

What it can do on your machine

Read from SKILL.md and the folder at commit 8ae6868. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

agtx Task Planning loads about 439 tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 215 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~439

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from fynnfluegge/agtx at commit 8ae6868, republished under its Apache-2.0 licence (© fynnfluegge). 215 words, ~439 tokens.

Download SKILL.mdSave it as .claude/skills/agtx-plan/SKILL.md (or your agent's skills folder).
name
agtx-plan
description
Plan a task implementation. Analyze the codebase, create a detailed plan, write it to .agtx/plan.md, then stop and wait for user approval before making any changes.

Planning Phase

You are in the planning phase of an agtx-managed task.

Input

The argument to this command is a task ID. Fetch the task description using the agtx MCP tool:

mcp__agtx__get_task(task_id: "<the id passed to this command>")

Use the description field as the task to work on. Also check for .agtx/research.md if a research phase was completed first.

Instructions

  1. Fetch the task description via get_task
  2. If .agtx/research.md exists, read it for prior analysis
  3. Explore the codebase to understand relevant files, patterns, and architecture
  4. Identify all files that need to be created or modified
  5. Create a detailed implementation plan

Output

Write your plan to .agtx/plan.md in the current working directory (do NOT navigate up — write directly to .agtx/plan.md relative to where you are now) with these sections:

Analysis

What you found in the codebase — relevant files, patterns, dependencies.

Plan

Step-by-step implementation plan — files to modify, approach, order of changes.

Risks

What could go wrong — edge cases, breaking changes, areas needing extra care.

CRITICAL: Stop After Writing

After writing .agtx/plan.md (in the current working directory):

  • Do NOT start implementing
  • Do NOT modify any source files
  • Say: "Plan written to .agtx/plan.md. Waiting for approval."
  • Wait for explicit instructions to proceed

Output Style

Terse. No pleasantries. Fragments OK. Short synonyms. Code exact. Status updates: one line. Pattern: [what] [why]. Done.

© fynnfluegge, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/agtx-terse/skills/agtx-plan of fynnfluegge/agtx.

Open the folder on GitHubat commit 8ae6868

Compare with similar skills

agtx Task Planning next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

agtx Task Planning compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
agtx Task Planning this skillfynnfluegge/agtx1.7k—~439Automated safety check: PassApache-2.0
OpenSpec Guided OnboardingFission-AI/OpenSpec72k1 repos~4.5kAutomated safety check: PassMIT
Codex with ChatGPT Planning LoopXiaoDuoYa/codex-with-chatgpt7.2k—~11kAutomated safety check: NotesMIT
Brainstorming Before BuildingjnMetaCode/superpowers-zh8.3k—~1.8kAutomated safety check: PassMIT
Spec Driven Developzhu1090093659/deepseek-pp1.9k—~6.9kAutomated safety check: PassApache-2.0
GSD Plan Importopen-gsd/gsd-core10k2 repos~1kAutomated safety check: NotesMIT

Similar skills

  • OpenSpec Guided Onboarding

    Fission-AI/OpenSpec

    Walks you through a complete OpenSpec workflow cycle with narration while doing real work in your codebase.

    72k GitHub starsUsed in 1 repo~4.5k tokens
    Agent WorkflowsAuto-check passed

  • Codex with ChatGPT Planning Loop

    XiaoDuoYa/codex-with-chatgpt

    Uses ChatGPT in the browser as the planning and review brain for a Codex session, with Codex keeping all execution and ChatGPT reading the workspace through a bridge.

    7.2k GitHub stars~11k tokensUpdated 10 days ago
    Agent WorkflowsAuto-check: notes

  • Brainstorming Before Building

    jnMetaCode/superpowers-zh

    Turns a rough idea into an approved design before any code is written, sorting the request into spike, bounded or architectural and enforcing an approval gate.

    8.3k GitHub stars~1.8k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed

  • Spec Driven Develop

    zhu1090093659/deepseek-pp

    Automates pre-development workflow for large-scale complex tasks.

    1.9k GitHub stars~6.9k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

  • GSD Plan Import

    open-gsd/gsd-core

    Ingest external plans with conflict detection against project decisions before writing anything.

    10k GitHub starsUsed in 2 repos~1k tokens
    Agent WorkflowsAuto-check: notes

  • Agentic Tool Integration

    samugit83/redamon

    Wiring a new tool the AI agent can call (not the recon pipeline): the tool registry, the phase map, the hardcoded dispatch chokepoint, and the duplicated execution paths that make a tool work in…

    3k GitHub stars~1.3k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed

More from fynnfluegge/agtx

  • agtx One-Shot Project Runner

    fynnfluegge/agtx

    Runs a whole project unattended on an agtx kanban board, decomposing the goal, starting tasks, unblocking workers and merging each result.

    1.7k GitHub stars~3.8k tokensUpdated 8 days ago
    Auto-check passed

  • Agtx Task Sweep

    fynnfluegge/agtx

    Breaks a conversation's results into feature-level tasks and pushes them to the agtx kanban board, where each task gets its own worktree and agent session.

    1.7k GitHub stars~1.7k tokensUpdated 8 days ago
    Auto-check passed

  • agtx Execute Phase

    fynnfluegge/agtx

    Carries out an approved plan for an agtx-managed task: implements the changes, runs tests, commits, writes a summary to .agtx/execute.md and then stops.

    1.7k GitHub stars~439 tokensUpdated 8 days ago
    Auto-check passed

  • Agtx Research

    fynnfluegge/agtx

    Explore the codebase to understand a task before planning. An agent skill from fynnfluegge/agtx.

    1.7k GitHub stars~399 tokensUpdated 8 days ago
    Auto-check passed

  • Agtx Brainstorm Mode

    fynnfluegge/agtx

    Puts the agent in a discussion-only mode for exploring a feature idea, asking questions and probing trade-offs without planning or writing code.

    1.7k GitHub stars~497 tokensUpdated 8 days ago
    Auto-check passed

  • agtx Review Phase

    fynnfluegge/agtx

    Self-reviews completed work in an agtx-managed task for correctness, edge cases and code quality, fixes issues, commits and writes .agtx/review.md with a status.

    1.7k GitHub stars~475 tokensUpdated 8 days ago
    Auto-check passed

Works with

Categories

Questions about agtx Task Planning

What does agtx Task Planning do?

Analyzes the codebase for an agtx task, writes a plan with analysis, steps and risks to .agtx/plan.md, then stops and waits for approval before any change. md if an earlier research phase produced it. It then explores the codebase for relevant files, patterns and architecture, and lists everything that must be created or modified.

When should I use agtx Task Planning?

agtx Task Planning fits situations like: planning a task from the agtx board before any code changes; producing a reviewable implementation plan with its risks listed; following up a research phase with a concrete plan.

How do I install agtx Task Planning in Claude Code?

Run `npx skills add fynnfluegge/agtx --skill agtx-plan -a claude-code`. Or copy the skill folder (plugins/agtx-terse/skills/agtx-plan in fynnfluegge/agtx) into .claude/skills/agtx-plan in your project. Claude Code loads it when a task matches its description.

How do I install agtx Task Planning in Codex?

Run `npx skills add fynnfluegge/agtx --skill agtx-plan -a codex`. Or copy the skill folder (plugins/agtx-terse/skills/agtx-plan in fynnfluegge/agtx) into .agents/skills/agtx-plan in your project. Codex loads it when a task matches its description.

Can I use agtx Task Planning in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fynnfluegge/agtx --skill agtx-plan -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agtx-plan, .gemini/skills/agtx-plan, .github/skills/agtx-plan and .opencode/skills/agtx-plan in your project.

What does agtx Task Planning need to run?

SKILL.md names no scripts, command-line tools or credentials: agtx Task Planning is instructions for the agent only. Our summary lists: The agtx MCP server for fetching task descriptions.

Does agtx Task Planning access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is agtx Task Planning safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does agtx Task Planning use?

agtx Task Planning is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does agtx Task Planning use?

About 439 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to agtx Task Planning?

Skills that share tags, products or a category with agtx Task Planning: OpenSpec Guided Onboarding (Fission-AI/OpenSpec, 72k stars), Codex with ChatGPT Planning Loop (XiaoDuoYa/codex-with-chatgpt, 7.2k stars), Brainstorming Before Building (jnMetaCode/superpowers-zh, 8.3k stars) and Spec Driven Develop (zhu1090093659/deepseek-pp, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains agtx Task Planning?

fynnfluegge (a GitHub user) maintains it in fynnfluegge/agtx, which has 1,713 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 2, 2026.

Source: fynnfluegge/agtx on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.