skills.rest
LucaDeLeo
LucaDeLeoCOMMUNITY
Explore all skills by this author →
GitHub

gsd:health-check

Validate Claude CLI, Codex CLI, skills, and MCP server configurations.

1|1|Updated Jan 17, 2026
Search Tags:#devops#cli#codex#claude#mcp#health-check#gsd
One-click install
npx skills add https://github.com/LucaDeLeo/ASTN --skill gsd-health-check
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd:health-check
Source: https://github.com/LucaDeLeo/ASTN/tree/main/.claude/skills/gsd-health-check
Command: npx skills add https://github.com/LucaDeLeo/ASTN --skill gsd-health-check

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux, claude, codex, jq, and includes scripts (resource) components.

What problem does it solve?

This health check verifies that a GSD environment is healthy by validating Claude CLI, Codex CLI (optional), the available skills registry, and MCP server configurations.

Core Features & Use Cases

  • Claude CLI check: Verifies CLI presence and basic authentication status.
  • Codex CLI check: Verifies optional Codex CLI presence and authentication status.
  • Skills inventory: Lists project-local or global skills and flags missing SKILL.md files.
  • MCP status: Reports configured MCP servers from .mcp.json or ~/.claude/settings.json and flags disabled servers.
  • Use Case: Before starting a GSD project, run the health check to confirm tooling is correctly configured.

Quick Start

Run the health check to verify your GSD environment and quickly identify misconfigurations.

Frequently Asked Questions about gsd:health-check

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

FAQPage Schema
How do I verify Claude CLI and MCP server configurations are working correctly?▼

To verify Claude CLI and MCP server configurations, run a health check that validates CLI presence, authentication status, and scans .mcp.json or ~/.claude/settings.json to report configured servers and flag disabled ones.

What is a GSD environment health check and when do I need to run it?▼

A GSD environment health check diagnoses your setup by validating Claude CLI, Codex CLI, available skills, and MCP configurations. You should run it before starting a GSD project to confirm tooling is correctly configured and identify misconfigurations.

How do I check for missing SKILL.md files in my Claude skills directory?▼

To check for missing SKILL.md files, run a skills inventory scan that lists project-local or global skills from .claude/skills or ~/.claude/skills and flags any entries lacking the required SKILL.md documentation.

Do I need Codex CLI installed to run a GSD health check?▼

You do not need Codex CLI installed to run a GSD health check because Codex CLI validation is optional. The health check will verify its presence and authentication status if it exists, but it is not a mandatory dependency.

What CLI dependencies are required to diagnose MCP and Claude CLI setup issues?▼

Diagnosing MCP and Claude CLI setup issues requires tmux, claude, codex, and jq CLI dependencies. These tools execute a deterministic health-check script that enumerates status and reports pass or fail outcomes for your configurations.

Why does my MCP server show as disabled when checking Claude settings?▼

Your MCP server shows as disabled when the health check scans .mcp.json or ~/.claude/settings.json and detects the server configuration is flagged as inactive, reporting it in the status output to alert you of the misconfiguration.

Related Skills

Explore More Software Engineering Skills→
madebywildmadebywild
12

harness-settings

Centralize provider-specific harness settings across Claude Code, OpenAI Codex CLI, and GitHub Copilot.

Official
Intermediate
okgoogle13okgoogle13
1

mcp-documentation-skill

Retrieve cached codebase documentation from the MCP server.

Community
Advanced
dasheddashed
22

tmux

Create, control, and clean up tmux sessions and panes.

Community
Advanced
FrogAiFrogAi
1

mcp-health-checker

Audit MCP server health across configured endpoints and generate a read-only dashboard.

Community
Advanced