session-start

Initialize or resume work sessions by loading context from runtime.json and project files.

69|12|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/gtapps/claude-code-hermit --skill session-start-gtapps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-start
Source: https://github.com/gtapps/claude-code-hermit/tree/main/plugins/claude-code-hermit/skills/session-start
Command: npx skills add https://github.com/gtapps/claude-code-hermit --skill session-start-gtapps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialize or resume a work session by loading context from OPERATOR.md and SHELL.md, orienting the agent, and establishing what to work on.

Core Features & Use Cases

  • Initialize or resume a session and prepare tasks with proper state management.
  • Load and validate context from runtime.json and project files, and ensure safe recovery paths.
  • Notify operators and route flow through the Hermit session lifecycle, including error handling and recovery.

Quick Start

Prompt the operator with the question "What should I help with?" to begin a new session.

Frequently Asked Questions about session-start

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I initialize a coding session using runtime.json state management?

To initialize a coding session with runtime.json state management, load and validate context from project files and runtime.json, then prompt the operator with "What should I help with?" to establish tasks and orient the agent.

What is the best way to resume a focused work session and recover agent state?

The best way to resume a focused work session is to load context from OPERATOR.md and SHELL.md, validate runtime.json, and route flow through the Hermit session lifecycle to ensure state consistency and safe recovery paths.

How do operator notifications work during session lifecycle transitions?

Operator notifications work by routing flow through the Hermit session lifecycle, managing idle, in_progress, and waiting transitions while handling errors and ensuring safe shutdown protocols during session state changes.

Can I use this session initialization approach for managing safe shutdown handling?

Yes, you can use this session initialization approach for safe shutdown handling, as it satisfies requirements for runtime.json-based state management, operator wire protocols, and recovery paths during work session transitions.

When do I need to apply session start workflow operations?

You need to apply session start workflow operations at the beginning of every work session and during transitions to ensure the agent is oriented, state is consistent, and operator notifications are managed properly.

Why does my agent lose context when transitioning between work session states?

Your agent loses context during work session state transitions because runtime.json state management and context loading from OPERATOR.md and SHELL.md were not properly initialized or validated before the transition occurred.