LeoYeAI/agent-master-skills / skills/agent-bom/troubleshoot
agent-bom-troubleshoot
VerifiedDiagnose issues, check prerequisites, and validate configurations. Use when: "doctor", "debug", "why failing", "validate config", "check prerequisites", "something is broken", "db status", "fix my setup".
agent-bom-troubleshoot — Diagnostics & Configuration Validator
Diagnoses issues, checks prerequisites, validates configurations, and reports on the health of the agent-bom installation and connected database.
Install
pipx install agent-bom
agent-bom doctor # check prerequisites and installation health
agent-bom validate # validate configuration files
agent-bom db status # check database connection status
When to Use
- "doctor" / "run doctor"
- "debug" / "help me debug"
- "why failing" / "something's broken"
- "validate config" / "check configuration"
- "check prerequisites"
- "db status" / "database status"
- "fix my setup"
Commands
# Run full diagnostic check
agent-bom doctor
# Validate configuration
agent-bom validate
# Check database status
agent-bom db status
Examples
# Run diagnostics
doctor()
# Validate config
validate()
# Check DB
db_status()
Example doctor output:
agent-bom doctor
Python 3.12.2 OK
agent-bom 0.75.9 OK
pip 24.0 OK
semgrep not found (optional — SAST scanning unavailable)
kubectl not found (optional — K8s context unavailable)
Config files found:
Claude Desktop ~/.config/Claude/claude_desktop_config.json OK
Cursor ~/.cursor/mcp.json OK
Database: SQLite ~/.agent-bom/db.sqlite OK
Last scan: 2 hours ago
Status: Ready
Guardrails
- Diagnostics are read-only — no configuration files are modified.
- Doctor checks do not transmit any data externally.
- If the user is experiencing an error, show the full diagnostic output before suggesting fixes.
- Validate configuration files before recommending changes.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |