Skip to content

LeoYeAI/agent-master-skills / skills/agent-bom/troubleshoot

agent-bom-troubleshoot

Verified

Diagnose 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.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall