system-diagnostics

Detects CortextOS agent operation stalls via stale tasks, goals, overdue human work, heartbeats, and metrics.

88|108|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/grandamenium/cortextos --skill system-diagnostics-grandamenium
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-diagnostics
Source: https://github.com/grandamenium/cortextos/tree/main/templates/analyst/.claude/skills/system-diagnostics
Command: npx skills add https://github.com/grandamenium/cortextos --skill system-diagnostics-grandamenium

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you identify why your cortextOS agent fleet feels stuck or wrong, so you can recover stalled tasks, outdated goals, and unhealthy system state quickly.

Core Features & Use Cases

  • Stale task detection: Finds tasks that have been in progress too long, pending too long, overdue, or waiting on humans without updates.
  • Goal staleness checks: Detects agents whose GOALS.md hasn’t been updated within a configurable threshold.
  • Human task monitoring: Surfaces overdue human-assigned work and prompts reminders.
  • Fleet heartbeat health summary: Aggregates agent heartbeat status to highlight agents that haven’t progressed recently.
  • Metrics collection: Captures a snapshot of task and agent activity for later review.

Core Features & Use Cases

  • Use Case: Run a morning health check to prevent invisible stalls, then investigate any critical findings (like overdue tasks or missing heartbeats) from the resulting alerts and summaries.

Quick Start

Run a full health check by asking cortextOS to execute the system diagnostics sequence for stale tasks, stale goals, human tasks, and fleet heartbeats.

Frequently Asked Questions about system-diagnostics

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

FAQPage Schema
How do I detect stalled agent tasks before they derail operations?

To detect stalled agent tasks, you run a system diagnostics health check that identifies stale in-progress work, pending items, and overdue human tasks. This routine heartbeat execution surfaces stuck operations early so you can recover stalled work before it causes invisible stalls.

What is fleet heartbeat monitoring and how does it track agent health?

Fleet heartbeat monitoring aggregates agent heartbeat status to highlight agents that haven't progressed recently. It checks operational metrics and fleet heartbeat status during morning reviews to provide a health summary showing which agents are active and which are quiet.

How do I check goal staleness when my agent fleet goes quiet?

You check goal staleness by reading and evaluating system state via bus commands that detect agents whose GOALS.md hasn't been updated within a configurable threshold. This troubleshooting step reveals outdated goals causing agents to stop moving or go quiet.

Can I surface overdue human-assigned work during a morning health check?

Yes, you can surface overdue human-assigned work by executing the system diagnostics sequence for human tasks. It monitors pending work waiting on humans without updates and prompts reminders so overdue items appear in your critical findings and alerts.

What's the best way to collect operational metrics for task triage?

The best way to collect operational metrics for task triage is to run a full diagnostics sequence that captures a snapshot of task and agent activity. This metrics collection provides a snapshot for later review alongside stale task detection and fleet heartbeat status.

When should I run system diagnostics for operations monitoring?

You should run system diagnostics for operations monitoring during routine heartbeat execution, morning reviews, and troubleshooting moments when tasks stop moving or agents go quiet. It evaluates stale tasks, goal staleness, human tasks, and fleet heartbeats to report critical findings.