team-question

team-question is a skill for Claude Code, Codex from bostonaholic/team. It costs 14 tokens per session (899 once invoked), scanned A, original, MIT.

A task-decomposition guide that turns a feature request, ticket, or issue into clear questions and planning documents for later work.

In plain words
What is it for?
It helps shape ideas, break down tasks, identify when a product document is needed, and record work across multiple repositories.
Why use it?
It prevents a vague request from being passed straight into implementation. It also separates the original intent from neutral questions used for research.

Skill for Claude CodeCodex

Written for Claude Code and Codex: argument-hint in frontmatter, but also agents/openai.yaml present. Also seen: mentions CLAUDE.md; names the AskUserQuestion tool.

Part of the team plugin — 16 skills, 13 agents, 2 hooks shipped together

Good fit It helps shape ideas, break down tasks, identify when a product document is needed, and record work across multiple repositories.

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

Made for: Claude Code, Codex.

Or install team, the plugin that ships this one along with the rest of its 16 skills, 13 agents, 2 hooks.

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 team-question

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

Your own site · 80×15
<a href="https://agentmods.dev/skills/bostonaholic/team/team-question"><img src="https://agentmods.dev/badge/skills/bostonaholic/team/team-question.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 14 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 899 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.00014 $0.00899
Opus 5.5 $0.00006 $0.00360
Sonnet 5.5 $0.00003 $0.00180
Haiku 4.5 $0.00001 $0.00090

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

Security

Grade A, and why

team-question 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 2d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/prepare-plan-dir.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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/team-question/SKILL.md · 69 lines

How it starts

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

Before each dispatch or retry, read host dispatch and supply its resolved installed paths. Before artifact work, read artifact schema. Before handling external values, read external-data rules.

Team Question

Before finalizing prose you author, read the writing standards.

Run the QUESTION phase only, then stop. The phase writes, in docs/plans/<id>/:

  • 1-task.md — the human's full intent. Never read by researcher or file-finder.
  • 2-questions.md — neutral research questions without intent; the only file researcher and file-finder read.
  • 3-prd.md — only under ## Conditional PRD in skills/team/playbooks/question.md.
  • 4-repos.md — only when the topic spans more than one repository: each involved repo's slug, absolute path, and role.

Execution

  1. Resolve $ARGUMENTS to a description:

    • Empty: discover, do not demand. Read recent git log activity and the repo's README / CLAUDE.md to propose a likely topic; use AskUserQuestion with labeled options only for a genuine gap in intent. Never bare-stop with a "describe it" demand when context is available.
    • Ticket-only: ask the user for context, or fetch the issue body through a configured tracker integration.
    • Issue URL: run gh issue view <url> --json title,body (or equivalent) and use the title plus body as the description.
    • Free text: use directly.

    A ticket identifier (e.g. ENG-1234) is recorded as ticketId in 1-task.md frontmatter. The orchestrator calls no ticketing system.

  2. Choose <kebab-topic>: a 2–4 word kebab-case slug derived from the description. Resolve <team-question-skill-dir> to the absolute directory containing this SKILL.md. From the repository root, run "<team-question-skill-dir>/scripts/prepare-plan-dir.sh" [--ticket <TICKET>] <kebab-topic>, passing --ticket only when a ticket identifier is present. Its dir= line is docs/plans/<id>/.

  3. Handle its exit code. Exit 2: fix the topic or ticket its stderr names and rerun. Exit 1 or 3: stop and report its stderr.

  4. Resume detection from its state= line:

    • new: the questioner writes every artifact.
    • questions-only: re-read 1-task.md instead of overwriting it; the questioner only writes 2-questions.md.
    • complete: skip dispatch and go to the report.
  5. Dispatch the questioner agent with the full description and the target directory docs/plans/<id>/. It writes the artifacts above.

  6. Stop once the rerun reports state=complete: rerun the step 2 command with --date <date> from its first date= line. Do not continue to RESEARCH. Any other state means the questioner did not write 1-task.md and 2-questions.md; report that and stop.

Read the full file on GitHub · 69 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 2d ago Changed · +1 lines · -7 tokens per session e6918dde5b05
  2. 27d ago Changed · -40 lines 8aebca3d4ac7
  3. 1mo ago Changed · -6 tokens per session 0539d5385253
  4. 1mo ago Changed · -5 tokens per session d8b0ef1ee91e
  5. 1mo ago Changed · -1 lines 51b7074105ea
  6. 1mo ago Changed · +5 lines 092201e67c5f
  7. 1mo ago Changed · +3 lines e6cd057220fb
  8. 1mo ago Changed · -4 lines · -14 tokens per session 6cc794c2aa92
  9. 1mo ago First seen · 105 lines · 46 tokens per session scan A d3c3a03b0633

Subscribe to this mod's changes

team-question is a skill published in the GitHub repository bostonaholic/team (11 stars, last pushed today), licensed MIT. It adds 14 tokens to every session and 899 once invoked, about $0.0001 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.