system-diagnostics

Probe backend readiness and generate structured health diagnostics reports.

3|2|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/AIMFllys/StudySolo --skill system-diagnostics-aimfllys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-diagnostics
Source: https://github.com/AIMFllys/StudySolo/tree/main/.agent/skills/system-diagnostics
Command: npx skills add https://github.com/AIMFllys/StudySolo --skill system-diagnostics-aimfllys

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, and includes scripts (resource) components.

What problem does it solve?

This Skill helps you verify that StudySolo’s backend, AI providers/models, sub-agents, and dependent services are reachable and healthy, producing auditable diagnostic reports with consistent logging.

Core Features & Use Cases

  • One-click system health verification across components, returning a structured healthy/unhealthy summary.
  • Category-scoped diagnostics for focused checks (database, ai_model, agent, service) when you don’t need full coverage.
  • Deterministic, log-backed evidence by forcing execution through the diagnostics script and saving outputs under scripts/logs/.

Quick Start

Ask the agent: “Run a full system health check and generate the diagnostics reports.”

Frequently Asked Questions about system-diagnostics

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

FAQPage Schema
How do I run an end-to-end system health check for backend services and AI models?

To run an end-to-end system health check, trigger the diagnostics script to probe backend readiness for AI models, agents, and databases. This forced script-based execution writes logs to scripts/logs/ and generates a structured report with exit codes and remediation guidance.

Can I perform focused health checks for specific categories like databases or AI models?

Yes, you can perform category-scoped diagnostics to run focused health checks for database, ai_model, agent, or service categories. This targets specific components without needing full coverage, returning a structured healthy or unhealthy summary.

What is the process for generating auditable diagnostic reports with consistent logging?

Generating auditable diagnostic reports requires mandatory activation confirmation and forced script-based execution. The process probes backend connectivity, saves output logs under scripts/logs/, and produces a structured report with exit codes and remediation guidance.

Does system health verification require a specific environment setup or dependencies?

System health verification requires the httpx dependency and operates by triggering the admin diagnostics endpoint. It requires mandatory activation confirmation before executing the script-based checks that write logs to the scripts/logs/ directory.

Why do backend connectivity tests fail to produce logs during diagnostics?

Backend connectivity tests fail to produce logs if not executed through the forced diagnostics script. The system mandates script-based execution that writes outputs to scripts/logs/ to ensure deterministic, log-backed evidence for the health check.