octo-agent

Diagnose OctoMesh bugs and CK model failures via MongoDB state analysis.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/meshmakers/octo-claude-skills --skill octo-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: octo-agent
Source: https://github.com/meshmakers/octo-claude-skills/tree/main/skills/octo-agent
Command: npx skills add https://github.com/meshmakers/octo-claude-skills --skill octo-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Investigate OctoMesh bugs, diagnose CK model failures (ResolveFailed, modelState, broken dependencies), inspect MongoDB tenant databases directly, perform selective builds to isolate issues, manage Docker volume backups for safe rollback, understand the DebugL NuGet dependency chain, and run targeted tests.

Core Features & Use Cases

  • Debugging and investigative workflow guidance for OctoMesh developers
  • Safe backup, baseline recording, and selective build/run strategies
  • Deep CK model and MongoDB diagnostics across tenants to isolate issues

Quick Start

Follow the decision tree and start a focused investigation by selecting a single affected area and running a targeted diagnostic sequence.

Frequently Asked Questions about octo-agent

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

FAQPage Schema
How do I diagnose CK model failures like ResolveFailed in OctoMesh?

Diagnose CK model failures by analyzing MongoDB state and reviewing dependency graphs to identify broken dependencies causing ResolveFailed or modelState errors across tenants. Run scoped diagnostic sequences and selective builds to isolate the root cause.

What's the best way to inspect MongoDB tenant databases for OctoMesh data integrity checks?

Inspect MongoDB tenant databases directly using scoped commands to verify data integrity and investigate runtime issues across tenants. Query CK models and review dependency graphs to ensure consistent state and isolate data anomalies.

How do I safely apply fixes during OctoMesh debugging without losing data?

Safely apply fixes by managing Docker volume backups for rollback and recording baselines before making changes. Use scoped commands to ensure fixes are targeted and reversible during the investigation workflow.

How do I run selective builds to isolate issues in OctoMesh build workflows?

Run selective builds to isolate issues by analyzing build workflows and reviewing the DebugL NuGet dependency chain. Execute targeted tests and scoped builds to identify specific failures within the build system.

Can I use this diagnostic workflow for OctoMesh deployment problems across multiple tenants?

Yes, you can use this workflow for deployment problems across multiple tenants. It supports deep CK model and MongoDB diagnostics across tenants to isolate issues and review dependency graphs for data integrity checks.

Why does OctoMesh debugging require understanding the DebugL NuGet dependency chain?

Understanding the DebugL NuGet dependency chain is required to trace broken dependencies and isolate build failures. Reviewing this chain helps identify why specific components fail during targeted tests and selective builds.