skills.rest
kamelmh
kamelmhCOMMUNITY
Explore all skills by this author →
GitHub

joc-doctor

Validate OpenCode JOC installation directories, files, and configuration structure.

Updated Aug 23, 2026
Search Tags:#skill discovery#mcp servers#configuration validation#installation diagnostics#joc#opencode.jsonc
One-click install
npx skills add https://github.com/kamelmh/opencode --skill joc-doctor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: joc-doctor
Source: https://github.com/kamelmh/opencode/tree/main/skills/joc-doctor
Command: npx skills add https://github.com/kamelmh/opencode --skill joc-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you identify what’s missing or misconfigured in a self-managed OpenCode JOC (Joint Operations Center) install, so the JOC hubs, skills, and supporting files can load and run correctly.

Core Features & Use Cases

  • Validates the global JOC directory layout: Checks the expected configuration root under ~/.config/opencode (or OPENCODE_CONFIG_DIR) and reports missing folders and required files like AGENTS.md and opencode.jsonc.
  • Inspects opencode.jsonc integrity and skill loading paths: Confirms the config is valid JSON and contains required keys (provider, instructions, skills) and that skills paths include local skill directories.
  • Audits inventories and integration points: Verifies AGENTS.md has content, counts skills/commands inventories, checks for the expected plugin file, and inspects MCP server configuration.

Quick Start

Run the JOC doctor to scan your setup: /joc-doctor

Frequently Asked Questions about joc-doctor

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

FAQPage Schema
How do I diagnose missing skills in my OpenCode JOC installation?▼

To diagnose missing skills in an OpenCode JOC installation, validate the global directory layout under ~/.config/opencode, check AGENTS.md content, and confirm opencode.jsonc contains valid skill loading paths.

Why does my opencode.jsonc configuration fail to load hubs and commands?▼

Your opencode.jsonc configuration fails to load hubs and commands when required JSON keys like provider, instructions, or skills are missing, or when local skill directory paths are misconfigured or invalid.

What is the best way to repair a broken OpenCode JOC skill discovery process?▼

The best way to repair broken OpenCode JOC skill discovery is to audit the configuration root, verify AGENTS.md presence, and ensure MCP server settings and plugin files are correctly loaded.

Does the JOC doctor validate MCP server settings and plugin files?▼

Yes, the JOC doctor validates MCP server settings and plugin files by inspecting expected plugin file existence and auditing the MCP server configuration structure within your OpenCode setup.

How do I fix an invalid opencode.jsonc file when JOC hubs are not loading?▼

To fix an invalid opencode.jsonc file when JOC hubs are not loading, run a diagnostic check to confirm the file is valid JSON and contains required provider, instructions, and skills keys.

What should I do if my OPENCODE_CONFIG_DIR is missing required agent instructions?▼

If your OPENCODE_CONFIG_DIR is missing required agent instructions, verify the directory structure and restore the AGENTS.md file to ensure the JOC environment can load properly.

Related Skills

Explore More Software Engineering Skills→
yxc023yxc023

custom-skill

Verify OPENCODE_CONFIG_DIR path resolution and configuration loading during skill activation.

Community
Basic
xtrm-devxtrm-dev
4

creating-service-skills

Generate operational skill packages for project services with two-phase research and registration validation.

Official
Advanced
AveerAveer
1

zeus-omo

Configure oh-my-opencode-slim plugin provider mappings, codebase maps, and tmux sessions.

Community
Intermediate
gtpgg1013gtpgg1013

doctor

Diagnose and fix oh-my-codex installation issues across macOS and Linux.

Community
Advanced