aget-check-sessions

Scan session directories for structural and naming anomalies with disk usage thresholds.

1|Updated Oct 4, 2025
One-click install
npx skills add https://github.com/gmelli/public-OpenAI-DeepResearch-aget --skill aget-check-sessions-gmelli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aget-check-sessions
Source: https://github.com/gmelli/public-OpenAI-DeepResearch-aget/tree/main/.claude/skills/aget-check-sessions
Command: npx skills add https://github.com/gmelli/public-OpenAI-DeepResearch-aget --skill aget-check-sessions-gmelli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide a lightweight diagnostic that assesses the health of a project's sessions directory by detecting structural anomalies, enforcing naming conventions, counting session and checkpoint files, and reporting disk usage so maintainers can spot organizational drift and storage issues.

Core Features & Use Cases

  • Structure checks to detect unexpected date-based subdirectories and confirm the presence of the expected checkpoints directory.
  • File inventory to count top-level session markdown files and checkpoint YAML files while excluding checkpoints from anomaly counts.
  • Naming convention validation that identifies files not matching the session_YYYY-MM-DD_*.md pattern and lists non-conforming filenames.
  • Disk usage measurement and threshold-based health classification (OK / WARN / CRITICAL) to support maintenance, cleanup planning, and alerts.
  • Read-only operation suitable for automated health checks, CI jobs, or periodic supervisor inspections.

Quick Start

Run the aget-check-sessions skill to scan the sessions directory and return a structured health report.

Frequently Asked Questions about aget-check-sessions

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

FAQPage Schema
How do I check the health of a sessions directory and detect structural anomalies?

To check the health of a sessions directory, scan the structure to detect unexpected date-based subdirectories, confirm the expected checkpoints directory exists, and report disk usage for maintenance and alerting.

What is the best way to validate session markdown file naming conventions?

Validating session markdown file naming conventions involves checking top-level files against the session_YYYY-MM-DD_*.md pattern to identify and list any non-conforming filenames that indicate organizational drift.

How do I count session and checkpoint files while measuring disk usage?

Count session and checkpoint files by inventorying top-level session markdown files and checkpoint YAML files separately, excluding checkpoints from anomaly counts, and computing total disk size for threshold-based health classification.

Can I run read-only filesystem health checks for automated CI jobs?

Yes, you can run read-only filesystem health checks suitable for automated CI jobs or periodic supervisor inspections to validate naming patterns and compute thresholds for total files and disk size without modifying data.

Why does the sessions health check report a WARN or CRITICAL status?

The sessions health check reports WARN or CRITICAL status based on computed thresholds for total file counts and disk size, classifying organizational drift and storage issues to support cleanup planning and alerts.