skills.rest
jonathanmalkin
jonathanmalkinCOMMUNITY
Explore all skills by this author →
GitHub

system-health

Diagnose Claude Code workspaces for syntax errors, broken references, and configuration inconsistencies.

61|9|Updated Mar 9, 2026
Search Tags:#code quality#deprecation#health check#system health#diagnostic#workspace management
One-click install
npx skills add https://github.com/jonathanmalkin/jules --skill system-health-jonathanmalkin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: system-health
Source: https://github.com/jonathanmalkin/jules/tree/main/.claude/skills/system-health
Command: npx skills add https://github.com/jonathanmalkin/jules --skill system-health-jonathanmalkin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill identifies and helps resolve issues within your Claude Code workspace, ensuring all components are functioning correctly and aligned with your directives.

Core Features & Use Cases

  • Comprehensive Diagnostics: Checks syntax, cross-references, file freshness, and configuration consistency.
  • Deprecation Triage: Identifies and helps manage outdated or orphaned scripts and files.
  • Directive Alignment: Maps diagnostic findings to your agent's core directives for prioritized action.
  • Use Case: Run a health check when you suspect issues with your Claude Code setup or before a major deployment to catch potential problems early.

Quick Start

Run a system health diagnostic and synthesize the findings.

Frequently Asked Questions about system-health

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

FAQPage Schema
How do I run a health check on my Claude Code workspace?▼

To run a health check, execute the system-health diagnostic to scan your Claude Code workspace for syntax errors, broken cross-references, and configuration inconsistencies. The tool synthesizes findings and provides prioritized recommendations for action.

What is deprecation triage in workspace management?▼

Deprecation triage is the process of identifying and managing outdated or orphaned scripts and files within your workspace. The diagnostic tool flags stale components and helps you resolve them before they cause issues during deployment.

Can I use this diagnostic tool to find broken cross-references in my code?▼

Yes, the system-health diagnostic performs comprehensive checks for broken cross-references, file staleness, syntax errors, and configuration inconsistencies across your Claude Code workspace.

How does directive alignment map diagnostic findings to agent actions?▼

Directive alignment maps raw diagnostic findings to your agent's core directives, using LLM judgment to synthesize and prioritize recommendations. This ensures that identified issues are resolved in order of importance to your setup.

When should I run a diagnostic health check on my workspace?▼

You should run a health check when you suspect issues with your Claude Code setup or before a major deployment to catch potential problems early. It identifies syntax errors, broken cross-references, and configuration inconsistencies.

Does the system-health diagnostic require any dependencies or external scripts?▼

No, the system-health diagnostic operates independently without requiring external dependencies. It runs scripts directly within your workspace to identify issues and synthesize findings with LLM judgment.

Related Skills

Explore More Software Engineering Skills→
tim-hubtim-hub
2

get-started

Bootstrap Claude Code by creating CLAUDE.md, configuring the statusline, and applying default settings.

Community
Intermediate
aresbitaresbit
46

ocaml-docs

Fix odoc documentation warnings and errors during OCaml dune builds.

Community
Advanced
abhishekdutta18abhishekdutta18

plankton-code-quality

Run formatters and linters to enforce code quality during file edits.

Community
Intermediate
EngineerWithAIEngineerWithAI
4

shellcheck-configuration

Configure ShellCheck for static analysis of shell scripts.

Official
Intermediate