Agent skill

Team Mode

by oil-oil in oil-oil/codex-team-mode

A skill your agent uses when a task may benefit from a bounded subagent for implementation, large-codebase discovery at task start, independent review, requested or pre-commit code simplification…

MITAuto-check passedAgent Workflows

Install Team Mode

skills CLI
$ npx skills add oil-oil/codex-team-mode --skill team-mode -a claude-code

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

GitHub CLI
$ gh skill install oil-oil/codex-team-mode team-mode --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/oil-oil/codex-team-mode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/team-mode .claude/skills/team-mode && 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
team-mode
GitHub stars
217
Token cost
~1.3k tokens
SKILL.md length
670 words
Files
10 (incl. scripts, references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when a task may benefit from a bounded subagent for implementation, large-codebase discovery at task start, independent review, requested or pre-commit code simplification…

  • A task may benefit from a bounded subagent for implementation
  • SKILL.md covers When to dispatch, Context and handoff, Expert help and Diagnostics
  • Runs Python scripts from its folder; calls python3
  • Large-codebase discovery at task start

What it does

Team Mode is an agent skill from oil-oil/codex-team-mode. Use when a task may benefit from a bounded subagent for implementation, large-codebase discovery at task start, independent review, requested or pre-commit code simplification, or expert work on complex decisions, modeling, automation, or repeated failures. The main agent chooses whether to delegate and accepts the result. Do not use for simple questions or short work with no meaningful review or delegation.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts and reference files (for example `README.md`, `agents/openai.yaml` and `references/custom-agents.md`).

It sits in Agent Workflows, covering Subagents and Code simplification. The repository describes itself as: 协调探索、执行和独立评审,让复杂任务按明确职责并行推进,由主 Agent 统一验收。 The licence is MIT.

When your agent uses it

  • A task may benefit from a bounded subagent for implementation
  • Large-codebase discovery at task start
  • Independent review
  • Pre-commit code simplification

Example prompts

  • “/team-mode”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 8eab25b. 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

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Team Mode loads about 1.3k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 105 tokens; SKILL.md has 670 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.2k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from oil-oil/codex-team-mode at commit 8eab25b, republished under its MIT licence (© oil-oil). 670 words, ~1,313 tokens.

Download SKILL.mdSave it as .claude/skills/team-mode/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
team-mode
description
Use when a task may benefit from a bounded subagent for implementation, large-codebase discovery at task start, independent review, requested or pre-commit code simplification, or expert work on complex decisions, modeling, automation, or repeated failures. The main agent chooses whether to delegate and accepts the result. Do not use for simple questions or short work with no meaningful review or delegation.
metadata.compatibility
Codex with custom subagents; local model and usage diagnostics require Python 3.10+ and retained session logs.

Team Mode

The main agent decomposes the user's task, decides what to delegate, and accepts the result. A task's size alone does not require subagents. On activation, send one brief commentary update in the user's language prefixed with 👾 (in Chinese: 👾 已开启小队模式。).

When to dispatch

Delegate a defined part of the task when a child can make useful progress through implementation, codebase discovery, review, or expert work. The main agent owns how the parts fit together, unresolved product decisions, and final acceptance. There is no target number of agents or required sequence.

Choose the smallest count that covers the independent work. One child is the default for one bounded question or review lens. Add children only when each can work and report independently, with a distinct question, scope, or lens. A large diff alone is not a reason to fan out.

Consider coordination and usage overhead. Respect the host's active-agent limit; if parallel dispatch is unavailable, continue sequentially or inline without silently dropping coverage.

  • Explorer — use for substantial codebase discovery at the start of a task. Handle small lookups and general research directly. Read Explore for this route.
  • Executor — use when the intended result and file ownership are clear enough for independent implementation. Give each target one owner.
  • Reviewer — use when the user asks for review or a completed result has a meaningful risk of unnoticed defects. Review the assigned result without steering toward a suspected answer; save a Markdown report when a lasting record helps.
  • ExpertAdvisor — use for a complex architecture or high-impact decision, a problem unresolved after repeated attempts, or modeling or complex computer automation the main agent cannot handle well. Ask for an independent plan or assign the expert a concrete outcome to produce.

When the user asks to simplify code, or before committing a code change, follow Simplify for scoped cleanup and final review. The main agent decides which findings to apply and accepts the final result.

For each dispatch, name the intended agent_type, count, independent scope, expected return, and write ownership. Keep write scopes separate when agents share a workspace.

Other configured roles and models are allowed when appropriate. Model and effort defaults, plus the optional default.toml sentinel, are described in profile setup; normal dispatch does not require reading it.

Show full SKILL.md (296 more words)Show less

Context and handoff

Start a new child with fork_turns="none" by default. Always use it for Reviewer and ExpertAdvisor, whose value depends on an independent view. Use it for Explorer too: a question and codebase path are usually enough.

An Executor may inherit a small number of recent parent turns when the assignment depends on decisions in that conversation that a short brief would likely omit. Use the smallest useful positive fork_turns value; inherit the full conversation only when the whole history is genuinely needed. Reuse an existing child for a direct continuation of its own assignment.

Give the child its assigned question or deliverable, relevant context, and scope. Include the broader user goal when it helps explain the assignment. Pass files, symptoms, and prior attempts as leads, not a fixed diagnosis or checklist. The child chooses its method within the assigned part; the main agent handles changes to the task breakdown and checks the returned work.

Expert help

When stronger expertise would help, use python3 scripts/current_model.py if the parent model is unclear. Choose an available stronger model and supported effort for the model-free ExpertAdvisor profile.

Give it the decision or outcome, relevant context, evidence, constraints, and scope without presenting a proposed cause as fact. The expert may produce a plan or carry out assigned modeling or complex automation. Check its result before accepting it. If no stronger model is available, continue without claiming a stronger-model consultation.

A model fixed in a custom profile takes precedence over a spawn-time choice. See profile setup for model changes; do not assume an explicit model overrides Explorer, Executor, or Reviewer.

Diagnostics

For a requested usage report, run python3 scripts/usage_by_model.py; read evaluation guidance when evaluating Team Mode itself. For an interactive-state task that code inspection cannot establish, read interactive testing guidance.

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

Files

SKILL.md and 9 other files (scripts, references) in skills/team-mode of oil-oil/codex-team-mode.

  • SKILL.md
  • README.md
  • agents/openai.yaml
  • references/custom-agents.md
  • references/evaluation.md
  • references/explore.md
  • references/interactive-testing.md
  • references/simplify.md
  • scripts/current_model.py
  • scripts/usage_by_model.py

Open the folder on GitHubat commit 8eab25b

Compare with similar skills

Team Mode 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.

Team Mode compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Team Mode this skilloil-oil/codex-team-mode217—~1.3kAutomated safety check: PassMIT
Subagent ReviewNikiforovAll/claude-code-rules141—~927Automated safety check: PassApache-2.0
Dead Code Removercode-yeongyu/oh-my-openagent70k—~1.8kAutomated safety check: PassCustom licence
Code SimplifierTwiTech-LAB/devchain101—~2kAutomated safety check: PassCustom licence
Review And Simplify ChangesDimillian/Skills4k—~2kAutomated safety check: PassMIT
Simplify Codesickn33/agentic-awesome-skills47k2 repos~1.8kAutomated safety check: PassMIT

Similar skills

  • Subagent Review

    NikiforovAll/claude-code-rules

    Review changed code for reuse, quality, and efficiency using three parallel disposable subagents.

    141 GitHub stars~927 tokensUpdated 9 days ago
    DevelopmentAuto-check passed
  • Dead Code Remover

    code-yeongyu/oh-my-openagent

    Finds unused code in a TypeScript project, confirms each candidate has no references through the language server, then hands removals to parallel agents.

    70k GitHub stars~1.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Code Simplifier

    TwiTech-LAB/devchain

    Review a change set for reuse, simplification, efficiency, and altitude problems, then apply the fixes while preserving exact behavior.

    101 GitHub stars~2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Review a git diff or explicit file scope for reuse, code quality, efficiency, clarity, and standards issues, then optionally apply safe Codex-driven fixes.

    4k GitHub stars~2k tokensUpdated 6 mo ago
    DevelopmentAuto-check passed
  • Simplify Code

    sickn33/agentic-awesome-skills

    Review a diff for clarity and safe simplifications, then optionally apply low-risk fixes.

    47k GitHub starsUsed in 2 repos~1.8k tokens
    DevelopmentAuto-check passed
  • Code Simplifier

    OpenHands/extensions

    Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality.

    163 GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed

Questions about Team Mode

What does Team Mode do?

A skill your agent uses when a task may benefit from a bounded subagent for implementation, large-codebase discovery at task start, independent review, requested or pre-commit code simplification…. Team Mode is an agent skill from oil-oil/codex-team-mode. Use when a task may benefit from a bounded subagent for implementation, large-codebase discovery at task start, independent review, requested or pre-commit code simplification, or expert work on complex decisions, modeling, automation, or repeated failures.

When should I use Team Mode?

Team Mode fits situations like: A task may benefit from a bounded subagent for implementation; large-codebase discovery at task start; independent review; pre-commit code simplification.

How do I install Team Mode in Claude Code?

Run `npx skills add oil-oil/codex-team-mode --skill team-mode -a claude-code`. Or copy the skill folder (skills/team-mode in oil-oil/codex-team-mode) into .claude/skills/team-mode in your project. Claude Code loads it when a task matches its description.

How do I install Team Mode in Codex?

Run `npx skills add oil-oil/codex-team-mode --skill team-mode -a codex`. Or copy the skill folder (skills/team-mode in oil-oil/codex-team-mode) into .agents/skills/team-mode in your project. Codex loads it when a task matches its description.

Can I use Team Mode 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 oil-oil/codex-team-mode --skill team-mode -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/team-mode, .gemini/skills/team-mode, .github/skills/team-mode and .opencode/skills/team-mode in your project.

What does Team Mode need to run?

Going by SKILL.md and its folder, Team Mode needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Team Mode 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 Team Mode 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Team Mode use?

Team Mode is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Team Mode use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.9k tokens, read only when the agent opens those files.

What are the alternatives to Team Mode?

Skills that share tags, products or a category with Team Mode: Subagent Review (NikiforovAll/claude-code-rules, 141 stars), Dead Code Remover (code-yeongyu/oh-my-openagent, 70k stars), Code Simplifier (TwiTech-LAB/devchain, 101 stars) and Review And Simplify Changes (Dimillian/Skills, 4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Team Mode?

oil-oil (a GitHub user) maintains it in oil-oil/codex-team-mode, which has 217 GitHub stars. The repository was last updated on October 1, 2026.

Source: oil-oil/codex-team-mode on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.