Agent skill

session-retention-debug

Diagnose and validate server session retention/reconnect behavior for TermLink. Use when checking session idle aging, retention TTL impact, active connection counts, and cleanup behavior via /api/sessions.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/session-retention-debug

SKILL.md

Session Retention Debug

Use this skill to validate the server-side session retention requirement and observe lifecycle behavior.

Run commands from repository root: E:\coding\TermLink

Quick Start

  1. Snapshot current sessions:
powershell
powershell -ExecutionPolicy Bypass -File ./skills/session-retention-debug/scripts/inspect-sessions.ps1 -BaseUrl http://127.0.0.1:3000 -User admin -Pass admin
  1. Monitor changes continuously:
powershell
powershell -ExecutionPolicy Bypass -File ./skills/session-retention-debug/scripts/watch-sessions.ps1 -BaseUrl http://127.0.0.1:3000 -User admin -Pass admin -IntervalSec 10

What It Verifies

  1. activeConnections changes correctly when clients connect/disconnect.
  2. Idle sessions are retained rather than immediately removed.
  3. Session aging (lastActiveAt) can be observed over time for TTL validation.
  4. Capacity pressure behavior can be observed by tracking total sessions.

Rules

  • Always target a specific environment via -BaseUrl.
  • Use authenticated calls when AUTH_ENABLED=true.
  • Do not infer retention from UI only; verify with /api/sessions snapshots.

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results