Agent skill

Session Management

by athola in athola/claude-night-market

Manages Claude Code sessions with naming, checkpointing, and resume strategies.

MITAuto-check passedDevelopment

Install Session Management

skills CLI
$ npx skills add athola/claude-night-market --skill session-management -a claude-code

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

GitHub CLI
$ gh skill install athola/claude-night-market session-management --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/athola/claude-night-market.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/sanctum/skills/session-management .claude/skills/session-management && 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
session-management
GitHub stars
342
Token cost
~2k tokens
SKILL.md length
817 words
Files
1
Skills in repo
159
Repo updated
First seen
Licence
MIT

At a glance

Manages Claude Code sessions with naming, checkpointing, and resume strategies.

  • Works in 8 steps: Debugging Sessions → Feature Development Checkpoints → PR Review Sessions → …
  • Organizing long-running work
  • SKILL.md covers When To Use, When NOT To Use, Overview and Available Commands, plus 7 more sections
  • Calls claude and gh; reaches github.com

What it does

Session Management is an agent skill from athola/claude-night-market. Manages Claude Code sessions with naming, checkpointing, and resume strategies. Use when organizing long-running work or resuming across sessions.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Authentication and Pull requests. The repository describes itself as: 23 Claude Code plugins: TDD enforcement hooks, git/PR workflows, spec-driven development, code review, project lifecycle, fix-from-error, maintenance automation, context… The licence is MIT.

When your agent uses it

  • Organizing long-running work
  • Resuming across sessions

Example prompts

  • “Use the session-management skill to manage Claude Code sessions with naming, checkpointing, and resume strategies”
  • “/session-management”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Debugging Sessions
  2. Feature Development Checkpoints
  3. PR Review Sessions
  4. PR-Linked Sessions (Claude Code 2.1.27+)
  5. Investigation Sessions
  6. Resume Hint on Exit (Claude Code 2.1.31+)
  7. Automatic Memory (Claude Code 2.1.32+)
  8. Agent Persistence on Resume (Claude Code 2.1.32+)

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • claude
    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    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

Session Management loads about 2k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 817 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~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); files beside SKILL.md are not scanned.

SKILL.md

The full file from athola/claude-night-market at commit 9f3eb00, republished under its MIT licence (© athola). 817 words, ~1,991 tokens.

Download SKILL.mdSave it as .claude/skills/session-management/SKILL.md (or your agent's skills folder).
name
session-management
description
Manages Claude Code sessions with naming, checkpointing, and resume strategies. Use when organizing long-running work or resuming across sessions.
alwaysApply
false
category
workflow
tags
session, resume, checkpoint, debugging
complexity
low
model_hint
fast
estimated_tokens
400

Session Management

When To Use

  • Managing session checkpoints and state preservation
  • Resuming work across Claude Code sessions

When NOT To Use

  • Short sessions that do not need checkpoints
  • Fresh starts where no prior session context exists

Overview

Claude Code supports named sessions for better workflow organization. Use this skill to manage complex, long-running work across multiple sessions.

Available Commands

CommandDescription
/renameName the current session (auto-generates name if no argument given, 2.1.41+)
/resumeResume a previous session (REPL)
claude --resume <name>Resume from terminal

Workflow Patterns

1. Debugging Sessions

Name debug sessions for easy resumption:

# Start debugging
/rename debugging-auth-issue

# ... work on the issue ...

# If you need to pause, session is auto-saved
# Resume later:
claude --resume debugging-auth-issue
2. Feature Development Checkpoints

Create checkpoints during long feature work:

# After completing milestone 1
/rename feature-x-milestone-1

# Continue in new session
# Reference old session if needed
3. PR Review Sessions

For complex PR reviews that span multiple sittings:

# Start review
/rename pr-review-123

# Take breaks without losing context
# Resume:
claude --resume pr-review-123
4. PR-Linked Sessions (Claude Code 2.1.27+)

Sessions are automatically linked to PRs when created via gh pr create. Resume PR-specific sessions later:

# Resume session for a specific PR
claude --from-pr 156
claude --from-pr https://github.com/org/repo/pull/156

# Workflow: review → pause → resume with full context
/rename pr-review-156
# ... review work ...
# Later:
claude --from-pr 156
5. Investigation Sessions

When investigating issues that may require research:

# Start investigation
/rename investigate-memory-leak

# Pause to gather more info externally
# Resume with full context:
claude --resume investigate-memory-leak

Resume Screen Features

The /resume screen provides:

  • Grouped forked sessions: See related sessions together
  • Keyboard shortcuts (defaults, customizable via /keybindings):
    • Preview session content
    • Rename a session
  • Recent sessions: Sorted by last activity
6. Resume Hint on Exit (Claude Code 2.1.31+)

Claude Code now shows a resume hint when you exit, displaying the command to continue your conversation. This makes session resumption more discoverable: users no longer need to know about --resume beforehand.

Best Practices

Naming Conventions

Use descriptive, hyphenated names:

PatternExampleUse Case
debugging-<issue>debugging-auth-401Bug investigation
feature-<name>-<milestone>feature-search-v2Feature development
pr-review-<number>pr-review-156PR reviews
investigate-<topic>investigate-perfResearch
refactor-<area>refactor-api-layerRefactoring work
When to Name Sessions

Name sessions when:

  • Work will span multiple days
  • You might need to pause unexpectedly
  • The session contains valuable context
  • You want to reference it later
Session Cleanup

Unnamed sessions are eventually garbage collected. Named sessions persist longer. Periodically clean up old named sessions you no longer need.

Integration with Sanctum

Combine session management with other Sanctum skills:

  1. Before starting: Run Skill(sanctum:git-workspace-review) to capture context
  2. Name the session: /rename <descriptive-name>
  3. Work: Use appropriate skills for the task
  4. Resume if needed: claude --resume <name>

Troubleshooting

Session Not Found

If a named session isn't appearing in /resume:

  • Check for typos in the name
  • Sessions may expire after extended inactivity
  • Use /resume screen to browse available sessions
Duplicate Sessions in VS Code

If you see duplicate session entries when resuming in VS Code:

  • Claude Code 2.1.38+: Fixed: resume now correctly reuses the existing session without creating duplicates
  • Older versions: Ignore the duplicate entries; they point to the same underlying session
Lost Context After Resume

If context seems incomplete or resume is slow:

  • Claude Code 2.1.30+: 68% memory reduction for --resume via stat-based session loading with progressive enrichment, especially impactful for users with many sessions. Also fixes hangs when resuming sessions with corrupted transcript files (parentUuid cycles).
  • Claude Code 2.1.29+: Fixed slow startup when resuming sessions with many once: true hooks: saved_hook_context loading is now optimized
  • Claude Code 2.1.21+: Fixed API errors when resuming sessions interrupted during tool execution: previously these sessions could fail to resume entirely
  • Claude Code 2.1.20+: Session compaction/resume is now fixed: resume correctly loads the compact summary instead of full history
  • Use /catchup to refresh git state
  • Use /debug (Claude Code 2.1.30+) for session troubleshooting diagnostics
  • Re-run Skill(sanctum:git-workspace-review) if needed
  • If on older versions: resumed sessions may reload uncompacted history, increasing context usage unexpectedly
Show full SKILL.md (263 more words)Show less
macOS Orphaned Processes (Claude Code 2.1.46+)

Previously, disconnecting from a terminal on macOS could leave orphaned Claude Code processes running. This is now fixed in 2.1.46+. If you encounter stale CC processes on older versions, manually check and kill them:

bash
# Find orphaned claude processes
ps aux | grep -i claude | grep -v grep
7. Automatic Memory (Claude Code 2.1.32+)

Claude now automatically records and recalls memories as it works. Session summaries, key results, and work logs are captured implicitly and recalled in future sessions. This provides passive cross-session continuity without manual checkpoint management.

  • No action required: Memory recording is automatic on first-party Anthropic API
  • Complements named sessions: Automatic memory handles implicit continuity; named sessions provide explicit organization
  • Token overhead: Recalled memories add to baseline context, factor this into MECW budgets
8. Agent Persistence on Resume (Claude Code 2.1.32+)

--resume now re-uses the --agent value from the previous conversation by default. Agent-specific workflows that are resumed will continue with the same agent configuration without needing to re-specify it.

# Start with a specific agent
claude --agent my-agent

# Resume later — my-agent is automatically used
claude --resume

See Also

  • /catchup - Refresh context from git changes
  • /clear - Start fresh session
  • Skill(sanctum:git-workspace-review) - Capture repo context

Exit Criteria

  • Session named via /rename using a hyphenated descriptive name matching one of the documented patterns (e.g. debugging-*, feature-*, pr-review-*)
  • Session resumes via claude --resume <name> without loss of prior context (verified by presence of earlier conversation)
  • If a session name is not found on resume, the error is surfaced with troubleshooting steps (check typos, session expiry)
  • For PR-linked sessions (Claude Code 2.1.27+), claude --from-pr <number> correctly reopens the session associated with that PR
  • If session context seems incomplete after resume, Skill(sanctum: git-workspace-review) is re-run and its output confirms current repo state

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

Files

Just SKILL.md in plugins/sanctum/skills/session-management of athola/claude-night-market.

Open the folder on GitHubat commit 9f3eb00

Compare with similar skills

Session Management 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.

Session Management compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Session Management this skillathola/claude-night-market342—~2kAutomated safety check: PassMIT
Deskcomm Contribuirmelgarafael/DeskcommCRM4.5k—~3.6kAutomated safety check: NotesMIT
LangBot Core Developmentlangbot-app/LangBot18k—~1.4kAutomated safety check: NotesApache-2.0
Bktavivsinai/bitbucket-cli2321 repos~1kAutomated safety check: PassMIT
Human Writingkataras/jwt212—~1.9kAutomated safety check: PassMIT
PR Reviewconfluentinc/mcp-confluent167—~4.6kAutomated safety check: NotesMIT

Similar skills

  • Deskcomm Contribuir

    melgarafael/DeskcommCRM

    Guia de contribuição ao DeskcommCRM para quem vai mexer no código e abrir um pull request, sobretudo de um fork.

    4.5k GitHub stars~3.6k tokensUpdated today
    DevelopmentAuto-check: notes
  • LangBot Core Development

    langbot-app/LangBot

    Covers developing the LangBot core backend and web UI: dev setup, repo layout, API auth types, adding endpoints, migrations and keeping the MCP server in step.

    18k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check: notes
  • Bkt

    avivsinai/bitbucket-cli

    Operate Bitbucket Cloud or Data Center repositories, pull requests, branches, issues, pipelines, permissions, and webhooks with bkt.

    232 GitHub starsUsed in 1 repo~1k tokens
    DevelopmentAuto-check passed
  • Human Writing

    kataras/jwt

    A skill your agent uses when writing or editing any prose in this repository - the book's preface, its chapters and epilogue, the brand kit notes, the agent skill documents, the changelog, and the…

    212 GitHub stars~1.9k tokensUpdated 25 days ago
    DevelopmentAuto-check passed
  • PR Review

    confluentinc/mcp-confluent

    Reviews pull requests for the Confluent MCP server. An agent skill from confluentinc/mcp-confluent.

    167 GitHub stars~4.6k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Mark Task Executed

    ethereum-optimism/superchain-ops

    Mark one or more superchain-ops tasks as EXECUTED by updating each task README's Status line to link the on-chain execution transaction, then open a PR.

    100 GitHub stars~679 tokensUpdated 3 days ago
    DevelopmentAuto-check passed

More from athola/claude-night-market

All 159 skills in this repo
  • Night Market Diagnostics Toolkit

    athola/claude-night-market

    Run and interpret repo diagnostic scripts (ratchets, validators, token stats).

    342 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • Skills Eval

    athola/claude-night-market

    Evaluate Claude skill quality through auditing. An agent skill from athola/claude-night-market.

    342 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed
  • Agent Teams

    athola/claude-night-market

    Coordinates Claude agent teams via filesystem protocol. An agent skill from athola/claude-night-market.

    342 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed
  • Delegation Core

    athola/claude-night-market

    Delegates execution to eight CLIs (Gemini, Qwen, MiniMax, GLM, Muse, Codex, OpenCode, Glimmer).

    342 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed
  • Elegant Code

    athola/claude-night-market

    Guide minimal code via a decision ladder with full safety, edge, and negative-case coverage.

    342 GitHub stars~2.1k tokensUpdated 2 days ago
    Auto-check passed
  • Skill Library Mission

    athola/claude-night-market

    Build a project skill library in .claude/skills/ via discovery, parallel authoring, and review.

    342 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed

Questions about Session Management

What does Session Management do?

Manages Claude Code sessions with naming, checkpointing, and resume strategies. Session Management is an agent skill from athola/claude-night-market. Manages Claude Code sessions with naming, checkpointing, and resume strategies.

When should I use Session Management?

Session Management fits situations like: organizing long-running work; resuming across sessions.

How do I install Session Management in Claude Code?

Run `npx skills add athola/claude-night-market --skill session-management -a claude-code`. Or copy the skill folder (plugins/sanctum/skills/session-management in athola/claude-night-market) into .claude/skills/session-management in your project. Claude Code loads it when a task matches its description.

How do I install Session Management in Codex?

Run `npx skills add athola/claude-night-market --skill session-management -a codex`. Or copy the skill folder (plugins/sanctum/skills/session-management in athola/claude-night-market) into .agents/skills/session-management in your project. Codex loads it when a task matches its description.

Can I use Session Management 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 athola/claude-night-market --skill session-management -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/session-management, .gemini/skills/session-management, .github/skills/session-management and .opencode/skills/session-management in your project.

What does Session Management need to run?

Going by SKILL.md and its folder, Session Management needs the command-line tools its instructions call (claude and gh).

Does Session Management access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Session Management 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. Review the folder before installing.

What licence does Session Management use?

Session Management 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 Session Management use?

About 2k tokens (SKILL.md is roughly 8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Session Management?

Skills that share tags, products or a category with Session Management: Deskcomm Contribuir (melgarafael/DeskcommCRM, 4.5k stars), LangBot Core Development (langbot-app/LangBot, 18k stars), Bkt (avivsinai/bitbucket-cli, 232 stars) and Human Writing (kataras/jwt, 212 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Management?

athola (a GitHub user) maintains it in athola/claude-night-market, which has 342 GitHub stars. The repository holds 159 skills in this directory. The repository was last updated on October 6, 2026.

Source: athola/claude-night-market on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.