agent-bom-troubleshoot
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".
Best use case
agent-bom-troubleshoot is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
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".
Teams using agent-bom-troubleshoot should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/troubleshoot/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How agent-bom-troubleshoot Compares
| Feature / Agent | agent-bom-troubleshoot | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
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".
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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
```bash
pipx install agent-bom
agent-bom doctor # check prerequisites and installation health
agent-bom mcp validate inventory.json # validate inventory 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
```bash
# Run full diagnostic check
agent-bom doctor
# Validate configuration
agent-bom mcp validate inventory.json
# 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
missing-guardrail-fixture
Fixture that intentionally omits the capability guardrail contract.
agent-bom-vulnerability-intel
Use agent-bom to check package, SBOM, inventory, and agent dependency exposure against OSV, GitHub Security Advisories, NVD, EPSS, and CISA KEV with explicit data-boundary choices. Use when a user asks for CVE lookup, advisory intelligence, exploitability context, fix versions, GHSA/OSV/NVD enrichment, or package vulnerability triage.
agent-bom-scan
Open security scanner for agentic infrastructure — agents, MCP, packages, blast radius, runtime, and trust for package CVEs (OSV, NVD, EPSS, KEV), container images, provenance, filesystems, and SBOMs. Use when: "check package", "scan image", "verify", "is this safe", "scan dependencies", "CVE lookup", "blast radius".
agent-bom-scan-infra
Scan infrastructure-as-code, cloud configurations, and find secrets. Use when: "check terraform", "scan kubernetes", "IaC", "find secrets", "scan dockerfile", "cloud security", "misconfigurations".
agent-bom-runtime
AI runtime security monitoring — context graph analysis, runtime audit log correlation with CVE findings, and vulnerability analytics queries. Use when the user mentions runtime monitoring, context graphs, lateral movement analysis, audit log correlation, or vulnerability analytics.
agent-bom-registry
MCP server security registry and trust assessment — look up servers in the 427+ server security metadata registry, run pre-install marketplace checks, batch fleet risk scoring, assess skill file trust, and run SAST code scans. Use when the user mentions MCP server trust, registry lookup, marketplace check, or skill trust assessment.
agent-bom-monitor
Monitor agent fleet, track trust scores, and manage lifecycle states. Use when: "fleet", "watch agents", "runtime status", "trust scores", "fleet sync", "agent lifecycle", "serve dashboard".
agent-bom-ingest
Validate and ingest operator-pushed agent-bom inventory JSON from AWS, Azure, GCP, Snowflake, CMDB, or endpoint collectors. Use when a user has canonical inventory JSON and wants local findings, graph, policy, provenance, or auditor-ready exports without giving agent-bom direct cloud credentials.
agent-bom-enforce
Enforce security policies on MCP tool calls and block dangerous operations at runtime. Use when: "block risky calls", "apply policy", "proxy", "runtime protection", "policy enforcement", "intercept MCP calls".
agent-bom-discover
Discover AI agents, MCP servers, and configurations on this machine or environment. Use when: "find agents", "what's configured", "doctor", "what MCP servers", "show me what's installed", "mcp inventory".
agent-bom-discover-snowflake
Discover Snowflake Cortex, Snowpark, notebook, Streamlit, MCP, and AI-observability assets from the operator's environment, emit canonical agent-bom inventory JSON, and scan it without giving agent-bom long-lived Snowflake credentials. Use when a user asks to inventory Snowflake AI or Cortex infrastructure as canonical inventory.
agent-bom-discover-gcp
Discover GCP-hosted AI agent and MCP-relevant assets from the operator's environment, emit canonical agent-bom inventory JSON, and scan it without giving agent-bom long-lived GCP credentials. Use when a user asks to inventory Vertex AI, Cloud Run, Cloud Functions, GKE, or agentic GCP infrastructure as canonical inventory.