Octo Agent

Debugging and investigation agent for OctoMesh — diagnoses CK model failures (ResolveFailed, modelState 2, broken dependencies, version-bump cascades), blueprint install failures, and CK migration problems; inspects MongoDB tenant databases directly; runs selective DebugL builds and targeted tests to isolate a regression; and manages Docker volume backups for safe rollback. Use it when something broke after a build, version bump, merge, or upgrade and you need to find the root cause safely. Trigger on: help me fix, investigate this bug, what broke, isolate the issue, why is the model broken, R

10 starsAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add meshmakers/octo-claude-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add meshmakers/octo-claude-skills --skill octo-agent
Manual install
git clone --depth 1 https://github.com/meshmakers/octo-claude-skills.git /tmp/octo-claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/octo-claude-skills/skills/octo-agent ~/.claude/skills/octo-agent

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# OctoMesh Developer Agent

## Purpose

Developer-facing debugging and investigation agent for OctoMesh. This skill provides deep platform knowledge for safely investigating bugs, performing selective builds, inspecting database state, and rolling back when things go wrong.

**Complements** the `octo-devtools` skill (build/start/stop operations) and `octo` skill (CLI/data exploration). This skill focuses on the **why** and **how** of debugging — understanding the build dependency chain, CK model internals, and safe investigation workflows.

**Prerequisites:**
- **`octo-devtools` skill** — this skill reuses its PowerShell wrapper (`run_pwsh.sh`) for build commands
- **MongoDB MCP server** — must be configured and connected for direct database diagnostic queries
- **Workspace root** — backup/restore operations require the working directory to be the OctoMesh monorepo workspace root (where `octo-tools/` lives)

## Decision Tree

When a developer needs help, determine the right approach:
Read the full skill on GitHub

Details

Skill name
octo-agent
Path
skills/octo-agent/SKILL.md
Repo updated
17 November 2026

FAQ

What does the Octo Agent skill do?

Debugging and investigation agent for OctoMesh — diagnoses CK model failures (ResolveFailed, modelState 2, broken dependencies, version-bump cascades), blueprint install failures, and CK migration problems; inspects MongoDB tenant databases directly; runs selective DebugL builds and targeted tests to isolate a regression; and manages Docker volume backups for safe rollback. Use it when something broke after a build, version bump, merge, or upgrade and you need to find the root cause safely. Trigger on: help me fix, investigate this bug, what broke, isolate the issue, why is the model broken, R

How do I install the Octo Agent skill?

Claude Code plugin: /plugin marketplace add meshmakers/octo-claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Octo Agent popular?

It lives in meshmakers/octo-claude-skills, which has 10 GitHub stars and 0 forks.

Related skills

Octo

10

meshmakers/octo-claude-skills

Primary entry point and router for ALL OctoMesh tasks. Drives the octo-cli for platform administration (users, roles, groups, tenants, clients, identity providers, blueprints, CK catalog/library management, stream-data archives, communication adapters/pipelines, AI services) and explores the data model and runtime instances via GraphQL. Routes specialized work to sibling skills. When unsure which OctoMesh skill to use, start here. Trigger on: OctoMesh, octo-cli, CLI command, environment switch, auth/login, AuthStatus, tenant, temporary tenant, test tenant, user, role, group, client credentials

Software Development

Octo App Builder

10

meshmakers/octo-claude-skills

Build a complete OctoMesh-powered application end to end — a custom Construction Kit data model published to the CK catalog, an HTTP API made of dataflow pipelines on the tenant's Mesh Adapter, an optional containerized web app the Communication Operator rolls out to Kubernetes, and a blueprint that packages all of it so a single InstallBlueprint provisions any tenant. Encodes the verified build sequence (model → pipelines → app image → blueprint → install → deploy → verify) and the pitfalls that silently break it (blueprint catalog cache, pipeline registration rotation, HTTP response shaping,

DevOps & Cloud

Octo Ck Miro

10

meshmakers/octo-claude-skills

Visualizes OctoMesh Construction Kits as UML class diagrams on a Miro board. Reads CK YAML definitions from a specified git branch in the local octo-construction-kit checkout (non-destructive via git show) and creates one detailed UML diagram per CK — types with attributes and datatypes, records, enums, inheritance arrows, associations with multiplicity, and cross-CK references. Lets the user pick a branch (default main) and choose between a new Miro board or adding to an existing board URL. Trigger on - visualize CK, visualize construction kit, CK diagram, CK to Miro, Miro board for CK, UML d

Git & Code Review

Octo Logs

10

meshmakers/octo-claude-skills

Query and trace OctoMesh logs, traces and metrics through the Dash0 MCP server — no credentials, port-forwards or logcli needed. Filter by namespace/container/pod/service/severity, search message bodies, count error rates with D0QL (SQL), trace an error across pod redeployments and jump from a log line to its trace. Loki/Promtail/LogQL are not used any more. Run /octo-logs-setup if the dash0 MCP tools are missing. Trigger on: logs, cluster logs, view logs, service logs, error logs, grep logs, tail logs, Dash0 logs, getLogRecords, D0QL, trace error, error over deployments, log retention, namesp

AI, LLMs & Agents

Layer Reference Sets

10

layerai/skills

Use when a look must hold across many Layer generations: training a custom style or LoRA on a studio's own artwork, curating the images that go into a reference set, choosing its training category, tuning reference-set weight on a run, or deciding whether to train at all rather than attach a style reference. Also when a trained style produces weak, inconsistent, or silently ignored results. Keywords: LoRA, custom model, trained style, reference set, consistency, on-model, art direction, dataset.

AI, LLMs & Agents

Octo Logs Setup

10

meshmakers/octo-claude-skills

One-time setup and health check of the Dash0 MCP connection that /octo-logs relies on to read OctoMesh cluster logs. Walks through registering the Dash0 MCP server in Claude Code, the browser OAuth login via /mcp, and verifies access with listDatasets. Replaces the former Loki credential setup (LOKI_USERNAME / LOKI_PASSWORD) — Loki no longer exists; old LOKI_* variables can be deleted from the private profile. Run this when the mcp__dash0__* tools are missing or return auth errors. Trigger on: set up log access, configure log access, octo-logs setup, Dash0 MCP, dash0 tools missing, mcp__dash0

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.