arbiterForge/codeArbiter / plugins/ca-codex/skills/ca-doctor
ca-doctor
VerifiedVerify the active host install, package, command ownership, enforcement, and harmless live-fire probe. Read-only.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
SKILL.md
View on GitHub---
name: ca-doctor
description: Verify the active host install, package, command ownership, enforcement, and harmless live-fire probe. Read-only.
argument-hint: (none)
---
# $ca-doctor — install health
Silent dormancy is the worst failure shape this plugin has: the gates look installed but never fire.
This command proves the active host is healthy and reports every non-OK finding with an exact
remediation.
## Flow
The mechanical report also invokes the installation-pinned artifact client's `capabilities`
operation. When the repository contains an HTML authority, it performs a bounded catalog read to
surface invalid or ambiguous artifacts. It MUST NOT load the artifact schema, search `PATH`, use a
repository binary, mutate an artifact, or silently fall back to Markdown.
Its executing-adapter identity comes from the already admitted plugin root. The observed adapter
manifest version is separate from the native helper manifest's declared version and the native
executable digest verified by the on-demand capability probe. A newer cached sibling is not the
executing version. Missing or malformed identity data is reported as unknown; it never grants
package trust.
- `CAPABILITY_MISSING` or another installation identity failure is unhealthy: report “repair or
reinstall the pinned artifact payload; HTML work is blocked.” Unrelated legacy Markdown remains
usable.
- An invalid HTML artifact is unhealthy: preserve the bounded engine code and direct the user to
inspect `repair-preview` before any explicit reviewed repair.
1. Resolve the plugin root from this loaded skill path, then run its `hooks/doctor.py` with Python 3
and present the report verbatim. Do not try an empty plugin-root environment variable first.
2. In an arbiter-enabled repo, attempt `git add --all --dry-run` via the shell tool. `[H-03]` means
hooks are firing; execution means **CRITICAL: gates dormant**.
## Remediation ladder
1. Restart Codex so hooks register at session start.
2. Remove and re-add `ca-codex@codearbiter`, then approve the changed hook set in `/hooks`.
3. If dormancy was intended, `$ca-init` opts the repository in.
## When NOT to use
- Scaffold state only → `$ca-init --check`.
- Project progress, not install health → `$ca-status`.
## Hard gate
Read-only. MUST NOT create markers, stage files, grant trust, weaken a block, or retry the live-fire
probe with different spelling. MUST surface a failed probe as CRITICAL, never as a footnote.
For an arbiter-enabled repository, the mechanical report treats the Git backstop as healthy only
after exact managed-shim and live-enforcer validation, plus a harmless selected-Git
`git hook run pre-push` probe with empty input. It never executes a foreign hook.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |