skills.rest
PiercingXX
PiercingXXCOMMUNITY
Explore all skills by this author →
GitHub

diagnose-stack

Verify MCP server layout, runtime config integrity, and agent/skill definitions.

1|Updated Jul 9, 2026
Search Tags:#drift detection#health checks#skill structure#mcp server#configuration validation#agent registry#stack diagnosis
One-click install
npx skills add https://github.com/PiercingXX/xx-stack --skill diagnose-stack
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diagnose-stack
Source: https://github.com/PiercingXX/xx-stack/tree/main/runtime/skills/diagnose-stack
Command: npx skills add https://github.com/PiercingXX/xx-stack --skill diagnose-stack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents downtime and slow failures by diagnosing configuration, wiring, and surface drift across the xx-stack agent ecosystem before you deploy or rely on it.

Core Features & Use Cases

  • Systematic health checks: Verifies MCP server layout, runtime config integrity, and the presence/validity of agent and skill definitions.
  • Drift and shadowing detection: Flags mirror inconsistencies between runtime canonical definitions and adapter or mirrored skills/agents.
  • Environment and wiring validation: Confirms required JSON/config files exist, checks documented wiring, and identifies missing or inconsistent adapter hooks.

Quick Start

Ask diagnose-stack to run a full health check of your xx-stack installation and return a PASS/WARN/FAIL table with actionable remediation for any failures.

Frequently Asked Questions about diagnose-stack

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

FAQPage Schema
How do I detect configuration drift in an MCP server before deploying to production?▼

Stack health diagnosis checks MCP server layout, runtime configuration integrity, and on-disk agent definitions by parsing JSON config files and cross-referencing runtime inventories to output a PASS/WARN/FAIL status table.

How do I validate agent and skill definitions on disk for an AI-assisted development environment?▼

Validating agent and skill definitions involves checking on-disk presence and validity by parsing runtime JSON config files and cross-referencing them against runtime inventories to report explicit PASS/WARN/FAIL statuses.

What is the best way to check runtime configuration integrity and wiring for an agent ecosystem?▼

Checking runtime configuration integrity involves confirming required JSON files exist, validating documented wiring, and identifying missing or inconsistent adapter hooks to prevent slow failures across the agent ecosystem.

Why does my mirrored skill definition not match the canonical runtime definition?▼

Mirrored skill definitions fail to match canonical runtime definitions due to drift and shadowing, which occurs when mirror inconsistencies exist between runtime canonical definitions and adapter or mirrored skills.

Can I run a full production readiness check for my AI stack without external dependencies?▼

Yes, you can run a full production readiness check without external dependencies by parsing and validating runtime JSON config files directly on disk to report explicit PASS/WARN/FAIL status aligned to the runtime-status contract.

Does stack diagnosis work for identifying missing or inconsistent adapter hooks?▼

Stack diagnosis works for identifying missing or inconsistent adapter hooks by confirming required JSON config files exist and checking documented wiring to report explicit PASS/WARN/FAIL status aligned to the runtime-status contract.

Related Skills

Explore More Software Engineering Skills→
gfargogfargo

stack-validation

Validate Strut stack layouts, configurations, and prerequisites for deployment.

Community
Advanced
jubscodesjubscodes
49

gspdev-audit

Audit GSP pipeline contracts, installer, runtime, versions, and templates.

Community
Advanced
FL03FL03

shepherd-context

Manage project state and synchronization with a SQLite-backed registry.

Community
Advanced
subhamay-bhattacharyyasubhamay-bhattacharyya

tf-config-json

Generate and validate AWS resource configuration JSON files for Terraform modules.

Official
Intermediate