fork-terminal-skill

Fork a terminal session to a new terminal window. Use this when the user requests 'fork terminal' or 'create a new terminal' or 'new terminal: <command>'.

📖 中文导读:Fork a terminal session to a new terminal window. Use this when the user requests 'fork terminal' or 'create a new terminal' or 'new terminal: <command>'. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: Fork Terminal Skill description: Fork a terminal session to a new terminal window. Use this when the user requests 'fork terminal' or 'create a new terminal' or 'new terminal: '.

Purpose

Fork a terminal session to a new terminal window Using one agentic coding tool or raw cli commands. Follow the Instructions, execute the Workflow, and refer to the Cookbook for decision-making.

Variables

ENABLED_RAW_CLI_COMMANDS: true ENABLED_GEMINI_CLI: true ENABLED_CODEX_CLI: true ENABLED_CLAUDE_CODE_CLI: true AGENTIC_CODING_TOOLS: claude-code, gemini-cli, codex-cli

Instructions

  • Based on the user's request, follow the Cookbook to determine which tool to use.

Fork Summary User Prompts

  • IF: the user requests a fork terminal with a summary. This ONLY works for our agentic coding tools AGENTIC_CODING_TOOLS. The tool must be enabled as well.
  • THEN:
    • Read, and REPLACE the .claude/skills/fork-terminal/prompts/fork_summary_user_prompt.md with the history of the conversation between you and the user so far.
    • Include the Next User Request section.
    • This will be what you pass into the prompt parameter for the agentic coding tool.
    • IMPORTANT: To be clear, don't update the file directly, just use it as your prompt when creating the agent.
  • EXAMPLES:
    • "Fork terminal use claude code to summarizing our conversation so far"
    • "Spin up a new terminal to with gemini cli agent summarizing our conversation so far"
    • "Create a new terminal to with codex cli agent with summary"

Workflow

  1. Understand the user's request.
  2. READ: .claude/skills/fork-terminal/tools/fork_terminal.py to understand our tooling.
  3. Follow the Cookbook to determine which tool to use.
  4. Execute using: uv run .claude/skills/fork-terminal/tools/fork_terminal.py '<command>'
    • Always use uv run, never python3 directly (requires Python 3.10+ for type union syntax)

Cookbook

If the request is for an agent you should follow the agent specific instructions even if we are requesting the agent to do a simple CLI command. For example, if the user requests "Create a new terminal to download a file with curl using claude code" you should follow the Claude Code Agent instructions.

Raw CLI Commands

  • IF: the user requests a non-agentic coding tool AND ENABLED_RAW_CLI_COMMANDS is true.
  • THEN: Read and execute: .claude/skills/fork-terminal/cookbook/cli-command.md
  • EXAMPLES:
    • "Create a new terminal to with ffmpeg"
    • "Create a new terminal to with curl"
    • "Create a new terminal to with python"

Claude Code Agent

  • IF: the user requests a claude code agent AND ENABLED_CLAUDE_CODE_CLI is true.
  • THEN: Read and execute: .claude/skills/fork-terminal/cookbook/claude-code.md
  • EXAMPLES:
    • "Fork terminal to with claude code"
    • "Create a new terminal to using claude"
    • "Spin up a new terminal to with claude agent"

Gemini CLI Agent

  • IF: the user requests a gemini cli agent AND ENABLED_GEMINI_CLI is true.
  • THEN: Read and execute: .claude/skills/fork-terminal/cookbook/gemini-cli.md
  • EXAMPLES:
    • "Fork terminal to with gemini cli"
    • "Create a new terminal to using gemini cli"
    • "Spin up a new terminal to with gemini cli agent"

Codex CLI Agent

  • IF: the user requests a codex cli agent AND ENABLED_CODEX_CLI is true.
  • THEN: Read and execute: .claude/skills/fork-terminal/cookbook/codex-cli.md
  • EXAMPLES:
    • "Fork terminal to with codex cli"
    • "Create a new terminal to using codex cli"
    • "Spin up a new terminal to with codex cli agent"