Forge:analyze

Deep Analysis

Deep analysis of a topic, question, or architectural decision using a dedicated model worker.

Usage

/forge:analyze [topic] [--models model]

Arguments

| Argument | Required | Description | | ---------- | -------- | -------------------------------------------------------------------------------------- | | topic | Optional | Question, file path, directory, or instruction on what to analyze (defaults to asking) | | --models | Optional | Comma-separated model list (default: claude-opus) | | --output | Optional | Write result to file instead of conversation (e.g., analysis.md) |

Available models: !forge workflow list-models

Only use models with status ready in the table above. If the default set includes unavailable models, pass --models explicitly. If the user explicitly requested an unavailable model, stop and tell them what proxy or credential is missing rather than silently substituting. If no models are ready, tell the user what's missing and stop.

---

Execution

Step 1: Resolve Topic and Flags

Parse $ARGUMENTS into a positional topic and optional flags. The topic is everything that is not a recognized flag (question, file path, directory, or free-form instruction). Strip any leading @ prefix on the topic. If no topic is found, ask the user what they want to analyze.

Recognized flags (extract from $ARGUMENTS if present):

• --models — comma-separated model list (default: claude-opus)
• --output — write result to file instead of conversation

Never ask the user to clarify. If $ARGUMENTS contains anything, proceed immediately.

Step 2: Run Deep Analysis

forge workflow analyze "the user's topic" [--models ] --json

Omit --models if the user didn't specify (defaults to claude-opus).

If the command exits with a non-zero code or returns invalid JSON, report the error to the user and stop. Do not attempt to parse partial output or fabricate a response.

Step 3: Present Analysis

Format the model's deep analysis as a structured response:

1. Problem decomposition
2. Key evidence and considerations
3. Analysis and trade-offs
4. Recommendations with rationale

If the model failed, report the error and suggest retrying.

Output routing: If --output was specified, write the complete analysis to that path using the Write tool (create parent directories if needed). Print a one-line confirmation: Wrote analysis to {path}. Do not also print the full result in the conversation. If --output was not specified, print the result in the conversation as usual.

---

Requirements

• Forge CLI: forge must be on PATH
• Claude Opus: Uses direct Anthropic (no proxy needed)

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: thomsonreuters
• Source: thomsonreuters/claude-forge
• License: Apache-2.0
• Homepage: https://pypi.org/project/tr-claude-forge/

Install and usage instructions live in the source repository linked above.