Skip to content
Development
Skill

/agtx-research

Explore the codebase to understand a task before planning. Write findings to .agtx/research.md and stop. This is a read-only exploration — do not modify any files.

From plugin
agtx
1.5k8 skills1 command1 MCP
Install
$ npx -y skills add fynnfluegge/agtx --skill agtx-research --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/agtx-research

Context preview

The summary Claude sees to decide when to auto-load this skill.

Explore the codebase to understand a task before planning. Write findings to .agtx/research.md and stop. This is a read-only exploration — do not modify any files.

SKILL.md

agtx-research.SKILL.md
name: agtx-research
description: Explore the codebase to understand a task before planning. Write findings to .agtx/research.md and stop. This is a read-only exploration — do not modify any files.

Research Phase

You are in the **research phase** of an agtx-managed task. This is a read-only exploration.

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.

Instructions

1. Fetch the task description via `get_task` 2. Explore the codebase to find relevant files, patterns, and architecture 3. Identify dependencies, related code, and potential complexity 4. Assess feasibility and estimate scope

Output

Write your findings to `.agtx/research.md`. Include:

Relevant Files

Key files and their roles — what exists, what needs changing.

Architecture

How the relevant parts of the codebase fit together.

Complexity

Assessment of scope — simple change, moderate refactor, or major undertaking.

Open Questions

Things that need clarification before planning can begin.

CRITICAL: Do Not Modify Code

This is a **read-only** exploration:

  • Do NOT modify any source files
  • Do NOT create branches or worktrees
  • Do NOT start planning or implementing
  • Say: "Research complete. Findings written to .agtx/research.md."
  • Wait for further instructions

Output Style

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

Read more
Ships withagtx

The terminal-native agentic development environment for 10x productivity. A blackboard for coding agents - One shared board. A fleet of agents.

Get the whole plugin
Stats
1,509
Stars
134
Forks
Active
Maintenance
Rust
Language
Apache-2.0
License
10h ago
Last commit
7mo ago
Created

Repo: fynnfluegge/agtx

Other skills on agtx.

oneshot
Skill

oneshot

One-shot a whole project on an agtx board: decompose the goal, run every task unattended, unblock the workers, and merge each one. Use when the user wants a…