Agent skill

System Diagnostics

by grandamenium in grandamenium/cortextos

Something in the system feels stuck or wrong — tasks are not moving, an agent has gone quiet, goals have not been updated in days, or the orchestrator has asked for a system health report.

MITAuto-check passed

Install System Diagnostics

skills CLI

$ npx skills add grandamenium/cortextos --skill system-diagnostics -a claude-code

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

GitHub CLI

$ gh skill install grandamenium/cortextos system-diagnostics --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/grandamenium/cortextos.git skills-src && mkdir -p .claude/skills && cp -r skills-src/community/skills/system-diagnostics .claude/skills/system-diagnostics && 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/

Paste into Claude Code

Install the "system-diagnostics" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/system-diagnostics into .claude/skills/system-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "system-diagnostics", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/grandamenium/cortextos/tree/main/community/skills/system-diagnostics

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add grandamenium/cortextos --skill system-diagnostics -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install grandamenium/cortextos system-diagnostics --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .agents/skills && cp -r skills-src/community/skills/system-diagnostics .agents/skills/system-diagnostics && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "system-diagnostics" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/system-diagnostics into .agents/skills/system-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "system-diagnostics", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add grandamenium/cortextos --skill system-diagnostics -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install grandamenium/cortextos system-diagnostics --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/community/skills/system-diagnostics .cursor/skills/system-diagnostics && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "system-diagnostics" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/system-diagnostics into .cursor/skills/system-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "system-diagnostics", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/grandamenium/cortextos.git --path community/skills/system-diagnostics

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add grandamenium/cortextos --skill system-diagnostics -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install grandamenium/cortextos system-diagnostics --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/community/skills/system-diagnostics .gemini/skills/system-diagnostics && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "system-diagnostics" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/system-diagnostics into .gemini/skills/system-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "system-diagnostics", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install grandamenium/cortextos system-diagnostics

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add grandamenium/cortextos --skill system-diagnostics -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .github/skills && cp -r skills-src/community/skills/system-diagnostics .github/skills/system-diagnostics && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "system-diagnostics" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/system-diagnostics into .github/skills/system-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "system-diagnostics", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add grandamenium/cortextos --skill system-diagnostics -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install grandamenium/cortextos system-diagnostics --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/community/skills/system-diagnostics .opencode/skills/system-diagnostics && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "system-diagnostics" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/system-diagnostics into .opencode/skills/system-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "system-diagnostics", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: system-diagnostics
GitHub stars: 101
Token cost: ~715 tokens
SKILL.md length: 176 words
Files: 1
Skills in repo: 55
Repo updated: Sep 23, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Something in the system feels stuck or wrong — tasks are not moving, an agent has gone quiet, goals have not been updated in days, or the orchestrator has asked for a system health report.

SKILL.md covers Stale Task Detection, Goal Staleness Check, Human Task Monitoring and Fleet Health Summary, plus 2 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

System Diagnostics is an agent skill from grandamenium/cortextos. Something in the system feels stuck or wrong — tasks are not moving, an agent has gone quiet, goals have not been updated in days, or the orchestrator has asked for a system health report. You need to run a structured check: stale tasks, stale goals, overdue human tasks, fleet heartbeat status, and metrics. This is your diagnostic toolkit. Run it on every heartbeat (orchestrator) and whenever something seems off.

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

The licence is MIT.

Example prompts

“/system-diagnostics”

What it can do on your machine

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

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
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

System Diagnostics loads about 715 tokens when it runs. Until then it costs about 109 tokens; SKILL.md has 176 words of instructions outside code blocks.

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

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 grandamenium/cortextos at commit 6f93838, republished under its MIT licence (© grandamenium). 176 words, ~715 tokens.

Download SKILL.mdSave it as .claude/skills/system-diagnostics/SKILL.md (or your agent's skills folder).

name: system-diagnostics
description: Something in the system feels stuck or wrong — tasks are not moving, an agent has gone quiet, goals have not been updated in days, or the orchestrator has asked for a system health report. You need to run a structured check: stale tasks, stale goals, overdue human tasks, fleet heartbeat status, and metrics. This is your diagnostic toolkit. Run it on every heartbeat (orchestrator) and whenever something seems off.
triggers: system health, health check, stale tasks, stale goals, fleet health, system status, what's stuck, blocked tasks, overdue tasks, goal staleness, collect…

System Diagnostics

Use these to detect and surface problems before they become crises.

Stale Task Detection

Find tasks that have been in-progress too long or pending without action:

bash

cortextos bus check-stale-tasks

Flags:

in_progress for more than 2 hours
pending for more than 24 hours
Human tasks with no update in 48 hours
Tasks past their due date

When to run: Every heartbeat (orchestrator), on suspicion of stuck work (all agents).

Goal Staleness Check

Detect agents whose GOALS.md hasn't been updated recently:

bash

# Default threshold (7 days)
cortextos bus check-goal-staleness

# Custom threshold
cortextos bus check-goal-staleness --threshold 3

# JSON output for parsing
cortextos bus check-goal-staleness --json

When to run: Weekly, or when an agent seems directionless.

Human Task Monitoring

Check for human-assigned tasks that are waiting too long:

bash

cortextos bus check-human-tasks

Sends reminders for overdue human tasks. Run daily (orchestrator) or when blocked waiting on a human.

Fleet Health Summary

Read all agent heartbeats at once:

bash

cortextos bus read-all-heartbeats

# JSON for parsing
cortextos bus read-all-heartbeats --format json

Stale threshold: agent hasn't updated in >6h = investigate.

Metrics Collection

Collect and record system metrics snapshot:

bash

cortextos bus collect-metrics

Run nightly (analyst cron). Captures task counts, completion rates, agent activity.

Full Health Check Sequence

Run this during morning review or when something feels off:

bash

echo "=== Fleet Heartbeats ==="
cortextos bus read-all-heartbeats

echo "=== Stale Tasks ==="
cortextos bus check-stale-tasks

echo "=== Stale Goals ==="
cortextos bus check-goal-staleness

echo "=== Human Tasks ==="
cortextos bus check-human-tasks

Surface any findings to the user via Telegram if critical.

Files

Just SKILL.md in community/skills/system-diagnostics of grandamenium/cortextos.

Open the folder on GitHubat commit 6f93838

Compare with similar skills

System Diagnostics 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.

System Diagnostics compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
System Diagnostics this skillgrandamenium/cortextos	101	—	~715	Automated safety check: Pass	MIT	16 days ago
Network Bgp Diagnosticsaffaan-m/ECC	276k	1 repos	~1.4k	Automated safety check: Pass	MIT	4 days ago
Triage Snmp Diagnosticsnetdata/netdata	81k	—	~3k	Automated safety check: Pass	GPL-3.0	today
Adding Ty Diagnosticsastral-sh/ruff	50k	—	~556	Automated safety check: Pass	MIT	today
Make Interfaces Feel Betteraffaan-m/ECC	276k	1 repos	~1.2k	Automated safety check: Pass	MIT	4 days ago
Diagnostics Developmentbiomejs/biome	26k	—	~1.2k	Automated safety check: Pass	Apache-2.0	today

Similar skills

Network Bgp Diagnostics
affaan-m/ECC
Diagnostics-only BGP troubleshooting patterns for neighbor state, route exchange, prefix policy, AS path inspection, and safe evidence collection.
276k GitHub starsUsed in 1 repo~1.4k tokens
SecurityAuto-check passed
Triage Snmp Diagnostics
netdata/netdata
Investigate captured SNMP diagnostics and support bundles, or review diagnostics-tool and evidence-interpretation changes.
81k GitHub stars~3k tokensUpdated today
DevOps & CloudAuto-check passed
Adding Ty Diagnostics
astral-sh/ruff
Official
A skill your agent uses when a user says "add a ty rule", "add a ty diagnostic", "write this new ty diagnostic", "change a ty error message", "review ty diagnostics", or asks to add, update, or…
50k GitHub stars~556 tokensUpdated today
DevelopmentAuto-check passed
Make Interfaces Feel Better
affaan-m/ECC
Apply concrete design-engineering details that make interfaces feel polished.
276k GitHub starsUsed in 1 repo~1.2k tokens
Frontend & DesignAuto-check passed
Diagnostics Development
biomejs/biome
Official
A skill your agent uses when designing or implementing Biome user-facing diagnostic presentation or APIs, including messages, advice, markup, details, code frames, categories, severity, and…
26k GitHub stars~1.2k tokensUpdated today
DevelopmentAuto-check passed
Bootstrap Diagnostics
kunchenguid/firstmate
Agent-only handling playbook for session-start bootstrap diagnostics.
7.7k GitHub stars~3.6k tokensUpdated yesterday
Auto-check: notes

More from grandamenium/cortextos

All 55 skills in this repo

Cortext Self Diagnosis
grandamenium/cortextos
Diagnose cortextOS itself when the framework misbehaves — an agent has gone silent or wedged, agents are crash-looping, Telegram or agent-to-agent messages are not arriving, crons did not fire, an…
101 GitHub stars~3.7k tokensUpdated 16 days ago
Auto-check passed
Activity Channel
grandamenium/cortextos
You have completed something significant and want the whole org — all agents and the user — to know about it.
101 GitHub stars~624 tokensUpdated 16 days ago
Auto-check passed
Agentcard Purchase
grandamenium/cortextos
You need to make a purchase on behalf of the user — buy a SaaS subscription, pay for an API, purchase a domain, or any transaction requiring a credit card.
101 GitHub stars~1.1k tokensUpdated 16 days ago
Auto-check passed
Claude To Codex Migration
grandamenium/cortextos
Migrate ANY cortextOS agent from the claude-code runtime to the live codex-app-server runtime.
101 GitHub stars~12k tokensUpdated 16 days ago
Auto-check: warnings
Bus Reference
grandamenium/cortextos
Complete cortextos bus CLI reference - all available commands with examples.
101 GitHub stars~3.8k tokensUpdated 16 days ago
Auto-check passed
Business News Monitor
grandamenium/cortextos
Daily cron-driven scan of news/forums/social in a domain to surface market shifts, new competitors, regulatory changes, and net-new opportunities.
101 GitHub stars~1.3k tokensUpdated 16 days ago
Auto-check passed

Questions about System Diagnostics

What does System Diagnostics do?

Something in the system feels stuck or wrong — tasks are not moving, an agent has gone quiet, goals have not been updated in days, or the orchestrator has asked for a system health report. System Diagnostics is an agent skill from grandamenium/cortextos. Something in the system feels stuck or wrong — tasks are not moving, an agent has gone quiet, goals have not been updated in days, or the orchestrator has asked for a system health report.

How do I install System Diagnostics in Claude Code?

Run `npx skills add grandamenium/cortextos --skill system-diagnostics -a claude-code`. Or copy the skill folder (community/skills/system-diagnostics in grandamenium/cortextos) into .claude/skills/system-diagnostics in your project. Claude Code loads it when a task matches its description.

How do I install System Diagnostics in Codex?

Run `npx skills add grandamenium/cortextos --skill system-diagnostics -a codex`. Or copy the skill folder (community/skills/system-diagnostics in grandamenium/cortextos) into .agents/skills/system-diagnostics in your project. Codex loads it when a task matches its description.

Can I use System Diagnostics 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 grandamenium/cortextos --skill system-diagnostics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/system-diagnostics, .gemini/skills/system-diagnostics, .github/skills/system-diagnostics and .opencode/skills/system-diagnostics in your project.

What does System Diagnostics need to run?

SKILL.md names no scripts, command-line tools or credentials: System Diagnostics is instructions for the agent only.

Does System Diagnostics 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 System Diagnostics 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 System Diagnostics use?

System Diagnostics 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 System Diagnostics use?

About 715 tokens (SKILL.md is roughly 2.9k 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 System Diagnostics?

Skills that share tags, products or a category with System Diagnostics: Network Bgp Diagnostics (affaan-m/ECC, 276k stars), Triage Snmp Diagnostics (netdata/netdata, 81k stars), Adding Ty Diagnostics (astral-sh/ruff, 50k stars) and Make Interfaces Feel Better (affaan-m/ECC, 276k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains System Diagnostics?

grandamenium (a GitHub user) maintains it in grandamenium/cortextos, which has 101 GitHub stars. The repository holds 55 skills in this directory. The repository was last updated on September 23, 2026.

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

Install System Diagnostics

Facts

At a glance

What it does

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

System Diagnostics

Stale Task Detection

Goal Staleness Check

Human Task Monitoring

Fleet Health Summary

Metrics Collection

Full Health Check Sequence

Files

Compare with similar skills

Similar skills

More from grandamenium/cortextos

Questions about System Diagnostics