Skip to content
Get packs

Session Flow Map

Reorient in a Claude Code session with an evidence-backed map of goals, pivots, and open decisions

Source Download skill
Repository
Yeachan-Heo/oh-my-claudecode
Stars
40,512
Licence
MIT
Files
1 file

What it does

When you switch sessions or the conversation gets compacted, this skill makes the agent rebuild a short timeline of what you were trying to do: the original goal, changes of direction, finished outcomes, abandoned paths, the current step, and decisions waiting on you. It cites a link or quote for each stage and marks guesses as inferred. It can also sync these stages into the session's native task list, or clear those tasks again on request.

Great for

  • Developers returning to a long Claude Code session after a break or a context compaction
  • People who want a quick status check of what was decided and what still needs their input

Skip it if

  • Tasks where you need the agent to plan or execute work; the skill is explicitly advisory and does not replace your task list (it only summarises the conversation)
  • Sessions with little history, where the map would be thin or padded; the skill is told to use fewer stages rather than invent work
  • Setups without native Task tools, where the map cannot be saved and reset cannot inspect or remove tasks

Try asking

  • “/session-flow to show the goal, stages, and open decisions for this session”
  • “/session-flow short to get just the goal, current stage, and anything needing my input”
  • “/session-flow reset to remove the session-flow tasks it created earlier”
Step-by-step guide: how to use Session Flow MapInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    session-flow.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip session-flow.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip session-flow.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Use the short mode when you only need a quick reorientation, since it is read-only and changes no tasks
  • Expect the map to mark pre-compaction reconstruction as inferred; check those lines against your own memory
  • Run reset when you want to clear the skill's task records; it only deletes tasks carrying the exact ownership marker

What's inside

  • SKILL.md

Redistributed unmodified from Yeachan-Heo/oh-my-claudecode under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.