skills.rest
RichardGeorgeDavis
RichardGeorgeDavisCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

agent-tooling-doctor

Diagnose agent tooling readiness and configuration drift across Codex, OMX, and OpenCode workspaces.

2|Updated Mar 17, 2026
Search Tags:#troubleshooting#codex#workspace#diagnose#opencode#omx#agent-tooling
One-click install
npx skills add https://github.com/RichardGeorgeDavis/Codex-Workspace --skill agent-tooling-doctor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-tooling-doctor
Source: https://github.com/RichardGeorgeDavis/Codex-Workspace/tree/main/shared/skills/agent-tooling-doctor
Command: npx skills add https://github.com/RichardGeorgeDavis/Codex-Workspace --skill agent-tooling-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose Codex/OpenCode/OMX repo-level agent readiness, configuration drift, and conflicting setups that hinder automation.

Core Features & Use Cases

  • Verify presence of repo guidance and agent layout files (AGENTS.md, .codex/skills/, .workspace/agent-stack.json, .opencode/, and .omx/).
  • Align repo-local agent configurations with workspace baseline and surface conflicts for remediation.
  • Provide deterministic checks and remediation guidance for onboarding and maintenance.

Quick Start

Run the doctor-agent-tooling.sh script to perform readiness checks and verify repository agent configurations.

Frequently Asked Questions about agent-tooling-doctor

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

FAQPage Schema
How do I diagnose repository agent configuration conflicts across Codex and OpenCode workspaces?▼

Diagnose repository agent configuration conflicts by running deterministic checks via the doctor-agent-tooling.sh script. It identifies readiness issues, verifies required layouts like AGENTS.md and .codex/skills/, and surfaces configuration drift between repo-local and workspace baseline settings.

What files are required for agent tooling readiness in OMX and OpenCode environments?▼

Required agent tooling readiness files include AGENTS.md, .codex/skills/, .workspace/agent-stack.json, .opencode/, and .omx/. The diagnostic script verifies the presence of these repository guidance and agent layout files to ensure proper automation setup.

How do I onboard a new repository to an agent workspace baseline?▼

Onboard a new repository to an agent workspace baseline by running the doctor-agent-tooling.sh script. It performs deterministic readiness checks, verifies required directory layouts, aligns per-repo settings, and provides remediation guidance for any missing configurations.

Why does my agent automation fail due to configuration drift between repo settings and the workspace baseline?▼

Agent automation fails due to configuration drift when per-repo settings conflict with the workspace baseline. The doctor-agent-tooling.sh script identifies these misalignments across Codex, OMX, and OpenCode environments and provides specific remediation guidance to resolve them.

Can I use the agent tooling doctor script to fix configuration conflicts without manual editing?▼

The agent tooling doctor script primarily identifies readiness issues and surfaces configuration conflicts for remediation. While it provides deterministic checks and remediation guidance, aligning repo-local agent configurations with the workspace baseline may require manual fixes based on the diagnostic output.

Related Skills

Explore More Software Engineering Skills→
dongzhuoyaodongzhuoyao
10

mem-init

Initialize canonical project memory and generate AGENTS.md and CLAUDE.md wrappers.

Community
Intermediate
SocketDevSocketDev
125

fleet-auditing-gha

Diff GitHub Actions settings against a canonical baseline to surface drift.

Official
Intermediate
RichardGeorgeDavisRichardGeorgeDavis
2

repo-onboarding

Onboard repositories into Codex Workspace with runtime metadata and agent-tooling conventions.

Community
Intermediate
agent-shagent-sh
951

maintain-cross-platform

Coordinate cross-platform release checks and configuration alignment across Claude Code, OpenCoder, and Codex.

Official
Advanced