skills.rest
josstei
jossteiCOMMUNITY
Explore all skills by this author →
𝕏@josstei_devGitHub

session-management

Manage Maestro orchestration session state with frontmatter-driven metadata and atomic file operations.

453|34|Updated Feb 9, 2026
Search Tags:#workflow#orchestration#session-management#resumption#state-management#maestro#token-tracking
One-click install
npx skills add https://github.com/josstei/maestro-gemini --skill session-management-josstei
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-management
Source: https://github.com/josstei/maestro-gemini/tree/main/skills/session-management
Command: npx skills add https://github.com/josstei/maestro-gemini --skill session-management-josstei

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maestro orchestrates complex multi-agent tasks but needs robust, persistent session state management across phases. This skill provides a standardized protocol to create, update, resume, and archive orchestration sessions, ensuring reliable tracking and recoverability.

Core Features & Use Cases

  • State access via MCP tools for deterministic operations, with a safe fallback to file-based state when tools are unavailable.
  • Hook-level transient state management to coordinate active agents and lifecycle across phases.
  • End-to-end session lifecycle: creation, progression through phases, resumption after interruptions, and archiving on completion.
  • Initialization templates and strict update protocols to keep session metadata, tokens, manifests, and downstream context consistent.

Quick Start

Initialize a new Maestro session, then monitor and update its state throughout phases until completion.

Frequently Asked Questions about session-management

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

FAQPage Schema
How do I resume an interrupted Maestro orchestration session?▼

Maestro orchestration session resumption is handled by reading frontmatter-driven metadata and enforcing deterministic state transitions to safely restore the exact phase where the interruption occurred.

What is orchestration session state management and why do I need it?▼

Orchestration session state management tracks lifecycle phases, token usage, and downstream context for multi-agent tasks, ensuring reliable recoverability and consistent metadata across complex workflow interruptions.

How do I track token usage across multi-agent workflow phases?▼

Token usage tracking across workflow phases is achieved through structured logging integrated into the session update protocol, which records token consumption and downstream context atomically during state transitions.

Can I manage Maestro session state when MCP tools are unavailable?▼

Yes, Maestro session state management remains functional when MCP tools are unavailable because the skill includes a safe fallback to file-based state operations using atomic file writes and strict frontmatter metadata.

What's the best way to automate orchestration session archiving on completion?▼

Automating orchestration session archiving is best handled by a standardized lifecycle protocol that triggers atomic file operations to safely archive the session state and metadata upon workflow completion.

How does Maestro handle hook-level transient state for active agents?▼

Hook-level transient state in Maestro is managed by coordinating active agents and lifecycle progression across phases, ensuring deterministic state transitions and consistent metadata updates throughout the orchestration workflow.

Related Skills

Explore More Software Engineering Skills→
shakefushakefu

init-session

Initializes and validates Contextium session state, creating .contextium directory and state/task files.

Community
Intermediate
Nickalus12Nickalus12
2

session-management

Manage Loom orchestration session state with YAML-based lifecycle tracking.

Community
Advanced
EmasoftEmasoft
13

amoa-orchestration-commands

Coordinate orchestration phase commands to start, monitor, run, and cancel multi-agent loops.

Community
Advanced
nnexainnexai
1

gsd-pause-work

Capture project state and pending tasks into a markdown handoff file with a WIP git commit.

Community
Advanced