debug-session

Diagnose session, batching, and routing issues in Samara workflows.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/claudeaceae/samara-main --skill debug-session
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-session
Source: https://github.com/claudeaceae/samara-main/tree/main/.claude/skills/debug-session
Command: npx skills add https://github.com/claudeaceae/samara-main --skill debug-session

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill diagnoses and resolves session continuity, message batching, and task routing issues in Samara when conversations become scrambled or group chats misbehave.

Core Features & Use Cases

  • Diagnostics for session state, batching, and chat routing to identify root causes.
  • Guidance to isolate and remediate isolated vs session-based task invocations.
  • Use cases: debugging scrambled batches, incorrect group routing, or overlapping tasks that stall responses, with clear remediation steps.

Quick Start

Run a diagnostic pass on the current Samara session and return actionable fixes to restore stable operation.

Frequently Asked Questions about debug-session

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

FAQPage Schema
How do I fix scrambled messages and group chat misrouting in Samara?

Fix scrambled messages and group chat misrouting by validating SessionManager, TaskRouter, and MessageBus workflows to identify root causes and apply concrete remediation steps that restore stable operation.

Why do concurrent tasks interfere and stall responses in Samara group chats?

Concurrent tasks stall responses in Samara group chats due to overlapping task invocations across messaging, memory, and routing layers; diagnosing session-based invocation logic isolates the interference to propose concrete fixes.

What is the best way to diagnose session continuity issues in Samara?

The best way to diagnose Samara session continuity issues is to analyze SessionManager, TaskRouter, and MessageBus workflows to validate state transitions and propose actionable fixes for stable operation.

How do I isolate session-based versus isolated task invocations during debugging?

Isolate session-based versus isolated task invocations by validating TaskRouter and MessageBus workflows to separate concurrent task paths and remediate routing interferences across the messaging layer.

Can I validate MessageBus workflows to resolve message batching problems in Samara?

Yes, validate MessageBus workflows in Samara to resolve message batching problems by diagnosing how scrambled batches are routed and applying targeted fixes to the TaskRouter and SessionManager components.