sequential-thinking

Original：🇺🇸 English

Translated

1 scriptsChecked / no sensitive code detected

Dynamic, reflective problem-solving through structured sequential thoughts with support for branching, revision, and adaptive depth. Use this skill when: (1) Breaking down complex problems into steps, (2) Planning and design with room for revision, (3) Analysis that might need course correction, (4) Problems where the full scope is not clear initially, (5) Multi-step solutions requiring maintained context, (6) Situations where irrelevant information must be filtered out, (7) Any task benefiting from hypothesis generation, verification, and iterative refinement. Triggers: think through, step by step, break this down, sequential thinking, reason through, analyze step by step, think carefully, or when a problem clearly benefits from structured multi-step reasoning.

4installs

Sourcethedotmack/sequential-thinking-skill

Added on2026-04-26

NPX Install

npx skill4agent add thedotmack/sequential-thinking-skill sequential-thinking

SKILL.md Content

View Translation Comparison →

Sequential Thinking

A tool for dynamic, reflective problem-solving through a chain of numbered thoughts. Full parity with the Sequential Thinking MCP server — same parameters, same state management, same behavioral contract.

How to Use This Skill

When this skill is activated, use
scripts/think.ts
as your primary reasoning mechanism. Do not reason in prose — reason through the script. Every step of your analysis should be a thought submitted via the script, making your reasoning chain explicit and trackable.

Workflow

Reset state at the start of every new thinking session
Loop: Submit thoughts one at a time via the script, incrementing
```
thoughtNumber
```
each time
Adapt: Revise earlier thoughts, branch into alternatives, or extend depth as needed
Terminate: Set
```
nextThoughtNeeded false
```
only when you have a confident final answer
Respond: After the final thought, provide the answer to the user

Each thought should be a single Bash tool call. Think in the thought, not outside it.

Script Location

scripts/think.ts

Run via

bun

from the skill's base directory.

Commands

Reset (required before every new session)

bash

bun scripts/think.ts --reset

Submit a Thought

Required flags:

--thought

,

--thoughtNumber

,

--totalThoughts

,

--nextThoughtNeeded

bash

bun scripts/think.ts \
  --thought "Your analysis for this step" \
  --thoughtNumber 1 \
  --totalThoughts 5 \
  --nextThoughtNeeded true

Submit a Revision

Revises a previous thought. The original stays in history; the revision is appended as a new entry. Requires

--isRevision

and

--revisesThought

.

bash

bun scripts/think.ts \
  --thought "Corrected analysis" \
  --thoughtNumber 3 \
  --totalThoughts 5 \
  --nextThoughtNeeded true \
  --isRevision --revisesThought 1

Submit a Branch

Explores an alternative path from a prior thought. Requires both

--branchFromThought

and

--branchId

.

bash

bun scripts/think.ts \
  --thought "Alternative approach" \
  --thoughtNumber 4 \
  --totalThoughts 7 \
  --nextThoughtNeeded true \
  --branchFromThought 2 --branchId alt-approach

Extend Depth

Signal that more thoughts are needed beyond the original estimate.

bash

bun scripts/think.ts \
  --thought "Scope is larger than expected" \
  --thoughtNumber 6 \
  --totalThoughts 8 \
  --nextThoughtNeeded true \
  --needsMoreThoughts

Inspect Full State

bash

bun scripts/think.ts --status

Returns JSON with

fullHistory

and

branchDetails

.

Output Format

Each thought invocation prints the thought to stderr and a compact status line to stdout:

💭 Thought 3/7
The analysis shows that...
[3/7] history=3 next=true

Revision and branch thoughts use

🔄 Revision

and

🌿 Branch

headers respectively.

Parameters (Full MCP Parity)

Parameter	Type	Required	Description
`--thought`	string	yes	The content of this thinking step
`--thoughtNumber`	int >= 1	yes	Current thought number in the sequence
`--totalThoughts`	int >= 1	yes	Estimated total thoughts needed (adjustable)
`--nextThoughtNeeded`	bool	yes	`true` to continue, `false` to terminate
`--isRevision`	flag	no	Marks this thought as revising a previous one
`--revisesThought`	int >= 1	no	Which thought number is being revised (required with `--isRevision` )
`--branchFromThought`	int >= 1	no	Create a branch starting from this thought number
`--branchId`	string	no	Label for the branch (required with `--branchFromThought` )
`--needsMoreThoughts`	flag	no	Signal that `totalThoughts` should be expanded

Behavioral Rules

These match the MCP server's tool description exactly:

Start with an initial estimate of
```
totalThoughts
```
, but adjust freely as understanding deepens
Auto-adjust: If
```
thoughtNumber
```
exceeds
```
totalThoughts
```
, the script raises
```
totalThoughts
```
to match
Revise previous thoughts when you realize an earlier step was wrong or incomplete — set
```
--isRevision
```
and
```
--revisesThought N
```
. The original stays in history; the revision is appended
Branch to explore alternative reasoning paths — set both
```
--branchFromThought N
```
and
```
--branchId label
```
. This does not abandon the main line
Extend beyond the initial estimate at any time with
```
--needsMoreThoughts
```
and an increased
```
--totalThoughts
```
Express uncertainty — not every thought needs confidence. Questioning and exploring is encouraged
Filter noise — ignore information irrelevant to the current step
Generate hypotheses when you have enough evidence, then verify them against prior thoughts in the chain
Iterate hypothesis-verification cycles until satisfied with the answer
Terminate only when you have a satisfactory answer — set
```
--nextThoughtNeeded false
```
Non-linear paths are first-class — branching, backtracking, and revision are features, not failures

State Management

State is persisted to
```
scripts/.think_state.json
```
between invocations
```
thoughtHistory[]
```
is append-only — thoughts are never deleted
```
branches{}
```
maps branch IDs to their thought arrays
```
--reset
```
clears all state for a fresh session
```
--status
```
dumps the full state as JSON for inspection

Example Session

See references/example-session.md for a complete worked example demonstrating normal thoughts, revisions, branches, and dynamic depth adjustment.

sequential-thinking

NPX Install

Tags

SKILL.md Content

Sequential Thinking

How to Use This Skill

Workflow

Script Location

Commands

Reset (required before every new session)

Submit a Thought

Submit a Revision

Submit a Branch

Extend Depth

Inspect Full State

Output Format

Parameters (Full MCP Parity)

Behavioral Rules

State Management

Example Session