Agent skill

Session Health

by flonat in flonat/flonat-research

Check whether the current session has coherent guidance, focus, handoff state, working-tree ownership, and enough context to proceed safely.

MITAuto-check passed

Install Session Health

skills CLI
$ npx skills add flonat/flonat-research --skill session-health -a claude-code

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

GitHub CLI
$ gh skill install flonat/flonat-research session-health --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/flonat/flonat-research.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/session-health .claude/skills/session-health && 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-health
GitHub stars
146
Token cost
~1.1k tokens
SKILL.md length
435 words
Files
1
Skills in repo
83
Repo updated
First seen
Licence
MIT

At a glance

Check whether the current session has coherent guidance, focus, handoff state, working-tree ownership, and enough context to proceed safely.

  • Works in 7 steps: Context Usage Estimate (host-aware) → Active Plan → Latest Session Log → …
  • Diagnosing a confused session
  • SKILL.md covers What to Check, Output Format and When to Use
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Session Health is an agent skill from flonat/flonat-research. Check whether the current session has coherent guidance, focus, handoff state, working-tree ownership, and enough context to proceed safely. Use when starting, resuming, or diagnosing a confused session. Not for auditing the machine or deployed AI infrastructure; use $system-audit.

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

The repository describes itself as: Shareable Claude Code + Codex infrastructure for PhD researchers — skills, agents, hooks, and rules for academic workflows. The licence is MIT.

When your agent uses it

  • Diagnosing a confused session

Example prompts

  • “/session-health”

Requirements

  • Pre-approved tools (allowed-tools): Read, Glob, Bash(ls*, cat*)

Workflow steps

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

  1. Context Usage Estimate (host-aware)
  2. Active Plan
  3. Latest Session Log
  4. Focus Freshness
  5. Preservation and Continuity
  6. Open Loops
  7. Compaction Guidance

What it can do on your machine

Read from SKILL.md and the folder at commit da27600. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Bash(ls*
    • cat*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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 Health loads about 1.1k tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 435 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

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 flonat/flonat-research at commit da27600, republished under its MIT licence (© flonat). 435 words, ~1,065 tokens.

Download SKILL.mdSave it as .claude/skills/session-health/SKILL.md (or your agent's skills folder).
name
session-health
description
Check whether the current session has coherent guidance, focus, handoff state, working-tree ownership, and enough context to proceed safely. Use when starting, resuming, or diagnosing a confused session. Not for auditing the machine or deployed AI infrastructure; use $system-audit.
allowed-tools
Read, Glob, Bash(ls*, cat*)

Context Status: Session Health Check

On-demand diagnostic showing context usage, preservation state, and open work items. Fast and lightweight — no vault queries.

What to Check

1. Context Usage Estimate (host-aware)

Use the active client's native context meter when it is exposed. A client adapter may provide a tool-call counter, but it is optional and must never be treated as shared memory. If no meter is available, report SKIPPED (client does not expose context telemetry); do not guess a percentage from conversation length.

Calculate:

  • Tool calls so far
  • Estimated percentage (calls / 150)
  • Which thresholds have fired (from the fired array)
  • Time since last warning
2. Active Plan

Find the latest file in log/plans/:

  • If found: show filename, first 3 lines, and whether it contains "APPROVED" or is still "DRAFT"
  • If none: report "No active plan"
3. Latest Session Log

Find the latest non-compact .md file in log/ (skip files with -compact in the name):

  • If found: show filename and first 3 lines
  • If none: report "No session log found"
4. Focus Freshness

Check when .context/current-focus.md was last modified:

  • Show the modification date
  • If older than 3 days: warn "Focus file is stale — consider running update-focus"
  • Show the first 5 lines (headline)
5. Preservation and Continuity

Verify the client-neutral continuity files first: applicable root guidance, .context/ai-handoff.md, .context/current-focus.md, latest approved plan, and portable memory index. Then read docs/reference/ai-surface-availability.md or run the staged AI-infrastructure doctor to report each client hook adapter as CONFIGURED, UNAVAILABLE, or NOT APPLICABLE. Missing optional lifecycle hooks are informational when the files-first layer is healthy.

Show full SKILL.md (180 more words)Show less
6. Open Loops

Count unchecked items (- [ ]) in .context/current-focus.md:

  • Report the count
  • If > 5: warn "Many open loops — consider triaging"

Output Format

Present as a compact status panel:

## Session Health

| Metric | Value |
|--------|-------|
| Context usage | ~XX% (N/150 tool calls) |
| Thresholds fired | none / info / warning / critical |
| Active plan | filename (DRAFT/APPROVED) / none |
| Latest log | filename / none |
| Focus freshness | N days ago / stale warning |
| Open loops | N items |

### Preservation Hooks

| Hook | Status |
|------|--------|
| Files-first continuity | HEALTHY / DEGRADED |
| Current client lifecycle adapter | CONFIGURED / UNAVAILABLE / NOT APPLICABLE |
| Context telemetry | AVAILABLE / SKIPPED |

### Recommendations

[Only if there are issues — e.g., stale focus, missing hooks, high context usage]
7. Compaction Guidance

When context is high (>60%), include these reference tables in the output:

When to compact:

Phase TransitionCompact?Why
Research to PlanningYesResearch context is bulky; plan is the distilled output
Planning to ImplementationYesPlan is in a file; free up context for code
Implementation to TestingMaybeKeep if tests reference recent code
Debugging to Next featureYesDebug traces pollute context
Mid-implementationNoLosing file paths and partial state is costly
After a failed approachYesClear dead-end reasoning

What survives compaction:

PersistsLost
CLAUDE.md / AGENTS.md + rulesIntermediate reasoning
Task listFile contents previously read
MEMORY.md + .context/Multi-step conversation context
Git stateTool call history
Files on diskVerbal preferences
.context/ai-handoff.md—

When to Use

  • When the context monitor fires a warning
  • Before starting a large task (to check remaining capacity)
  • After resuming a session (to verify state was preserved)
  • When unsure if preservation hooks are working

© flonat, 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 skills/session-health of flonat/flonat-research.

Open the folder on GitHubat commit da27600

Compare with similar skills

Session Health 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 Health compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Session Health this skillflonat/flonat-research146—~1.1kAutomated safety check: PassMIT
Skin Health Analyzersickn33/agentic-awesome-skills47k2 repos~293Automated safety check: PassMIT
Codebase Health Dashboardgarrytan/gstack136k—~11kAutomated safety check: NotesMIT
Daily Focus Boardgithub/awesome-copilot40k—~3kAutomated safety check: PassMIT
Healthagenticnotetaking/arscontexta3.5k—~7.1kAutomated safety check: NotesMIT
Health Wellnesssickn33/agentic-awesome-skills47k1 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • Skin Health Analyzer

    sickn33/agentic-awesome-skills

    Analyze skin health data, identify skin problem patterns, assess skin health status.

    47k GitHub starsUsed in 2 repos~293 tokens
    Productivity & AutomationAuto-check passed
  • Runs a project's own type checker, linter, test runner, dead-code detector and shell linter, combines them into a weighted 0-10 score and tracks the trend.

    136k GitHub stars~11k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Daily Focus Board

    github/awesome-copilot

    Official

    Builds a warm, browser-based daily focus board the user updates by talking to their agent, with Eisenhower priorities, a brain-dump box and kind not-today carryover.

    40k GitHub stars~3k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Health

    agenticnotetaking/arscontexta

    Run condition-based vault health diagnostics. An agent skill from agenticnotetaking/arscontexta.

    3.5k GitHub stars~7.1k tokensUpdated 7 mo ago
    Auto-check: notes
  • Health Wellness

    sickn33/agentic-awesome-skills

    Wellbeing check-in register: anonymous flag, department, check-in date, wellbeing score, stress and energy levels, support and resource flags, confidentiality and status.

    47k GitHub starsUsed in 1 repo~3.5k tokens
    Productivity & AutomationAuto-check passed
  • Focus Styles

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing stylesheets, component styles, and responsive behavior related to Provide visible custom focus indicators.

    74k GitHub stars~639 tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed

More from flonat/flonat-research

All 83 skills in this repo
  • Latex Posters

    flonat/flonat-research

    Create a large-format academic poster in LaTeX using beamerposter, tikzposter, or baposter.

    146 GitHub stars~1.5k tokensUpdated 11 days ago
    Auto-check: notes
  • Skill Creator

    flonat/flonat-research

    Create, revise, and evaluate reusable AI workflow skills, including trigger-quality tests.

    146 GitHub stars~4.4k tokensUpdated 11 days ago
    Auto-check passed
  • DOCX

    flonat/flonat-research

    Create, read, edit, or convert Microsoft Word documents while preserving professional document structure.

    146 GitHub stars~1.2k tokensUpdated 11 days ago
    Auto-check passed
  • PDF

    flonat/flonat-research

    Read, create, combine, split, rotate, OCR, watermark, secure, or extract content from PDF files.

    146 GitHub stars~488 tokensUpdated 11 days ago
    Auto-check passed
  • Init Project Orchestration

    flonat/flonat-research

    Create or migrate project-level agents, repeatable project workflows, and planning state from one client-neutral contract, then render repository-scoped adapters for both Claude Code and Codex.

    146 GitHub stars~1.6k tokensUpdated 11 days ago
    Auto-check passed
  • Pre Commit Audit

    flonat/flonat-research

    Deliver a fast pre-commit safety scan: file size, anonymity (author / affiliation strings in tex/bib), hardcoded secrets, and invisible-Unicode carriers.

    146 GitHub stars~2.8k tokensUpdated 11 days ago
    Auto-check: notes

Questions about Session Health

What does Session Health do?

Check whether the current session has coherent guidance, focus, handoff state, working-tree ownership, and enough context to proceed safely. Session Health is an agent skill from flonat/flonat-research. Check whether the current session has coherent guidance, focus, handoff state, working-tree ownership, and enough context to proceed safely.

When should I use Session Health?

Session Health fits situations like: diagnosing a confused session.

How do I install Session Health in Claude Code?

Run `npx skills add flonat/flonat-research --skill session-health -a claude-code`. Or copy the skill folder (skills/session-health in flonat/flonat-research) into .claude/skills/session-health in your project. Claude Code loads it when a task matches its description.

How do I install Session Health in Codex?

Run `npx skills add flonat/flonat-research --skill session-health -a codex`. Or copy the skill folder (skills/session-health in flonat/flonat-research) into .agents/skills/session-health in your project. Codex loads it when a task matches its description.

Can I use Session Health 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 flonat/flonat-research --skill session-health -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-health, .gemini/skills/session-health, .github/skills/session-health and .opencode/skills/session-health in your project.

What does Session Health need to run?

SKILL.md names no scripts, command-line tools or credentials: Session Health is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Glob, Bash(ls*, cat*).

Does Session Health access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Session Health 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 Health use?

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

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Health?

Skills that share tags, products or a category with Session Health: Skin Health Analyzer (sickn33/agentic-awesome-skills, 47k stars), Codebase Health Dashboard (garrytan/gstack, 136k stars), Daily Focus Board (github/awesome-copilot, 40k stars) and Health (agenticnotetaking/arscontexta, 3.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Health?

flonat (a GitHub user) maintains it in flonat/flonat-research, which has 146 GitHub stars. The repository holds 83 skills in this directory. The repository was last updated on September 29, 2026.

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