Claude Skill

ca-doctor

Verify the active host install, package, command ownership, enforcement, wrapper self-test, and active-dispatch coverage gap. Read-only.

LLM Mart · 0 points · 18 views 0 listing impressions 0 install-command copies
Download arbiterForge-codeArbiter-plugins_ca-pi_skills_ca-doctor-9b8989c.zip · 1 KB

Install

skills CLI npx skills add https://github.com/arbiterForge/codeArbiter/tree/main/plugins/ca-pi/skills/ca-doctor
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install arbiterforge-codearbiter@llmmart
Git git clone https://github.com/arbiterForge/codeArbiter.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole arbiterforge/codearbiter collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

/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. The /ca-doctor alias has already run the extension's structured Pi doctor report before sending this generated skill. Present the <codearbiter-doctor-report> block below verbatim.
  2. The report inspects, without granting trust: active Git package origin/version, exact Pi CLI and module package identity, stable Pi/Node/Python support, shared-core and bridge paths, command and native-equivalent skill-expansion ownership, child/ambient-marker state, and final wrapper sources.
  3. Its wrapper-self-test row submits only git add --all --dry-run directly to the stored governed Pi bash wrapper. The exact shared-core [H-03] block is healthy and cannot stage files; execution or a different block is unhealthy. This self-test does not traverse Pi's active dispatcher. Do not rerun or respell it.
  4. Its active-dispatch row remains degraded because supported Pi 1.1.0 public extension APIs cannot submit that deterministic call through the active dispatcher. PI-AC-28 remains blocked until supported-version real-host promotion/CI evidence closes the gap.
  5. Resolve Python once, run <plugin-root>/hooks/doctor.py, and present its mechanical report verbatim. This is the on-demand artifact-capability and repository-artifact check; it is separate from the wrapper self-test and must not be respelled into an active-dispatch claim.

Remediation ladder

  1. Restart Pi so package resources and final wrappers register in one fresh process.
  2. Reinstall ca-pi from the approved pinned Git tag. For project-local packages, inspect /trust and grant trust only if you accept that source; codeArbiter never grants it.
  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 wrapper self-test with different spelling. MUST preserve the degraded active-dispatch diagnosis until supported-version real-host promotion/CI evidence closes PI-AC-28.

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.

Files (codearbiter)
  • SKILL.md 3.9 KB
    ---
    name: ca-doctor
    description: Verify the active host install, package, command ownership, enforcement, wrapper self-test, and active-dispatch coverage gap. 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. The `/ca-doctor` alias has already run the extension's structured Pi doctor report before sending
       this generated skill. Present the `<codearbiter-doctor-report>` block below verbatim.
    2. The report inspects, without granting trust: active Git package origin/version, exact Pi CLI and
       module package identity, stable Pi/Node/Python support, shared-core and bridge paths, command and
       native-equivalent skill-expansion ownership, child/ambient-marker state, and final wrapper sources.
    3. Its `wrapper-self-test` row submits only `git add --all --dry-run` directly to the stored governed
       Pi bash wrapper. The exact shared-core `[H-03]` block is healthy and cannot stage files; execution
       or a different block is unhealthy. This self-test does not traverse Pi's active dispatcher. Do not
       rerun or respell it.
    4. Its `active-dispatch` row remains degraded because supported Pi 1.1.0 public extension
       APIs cannot submit that deterministic call through the active dispatcher. PI-AC-28 remains blocked
       until supported-version real-host promotion/CI evidence closes the gap.
    5. Resolve Python once, run `<plugin-root>/hooks/doctor.py`, and present its mechanical report
       verbatim. This is the on-demand artifact-capability and repository-artifact check; it is separate
       from the wrapper self-test and must not be respelled into an active-dispatch claim.
    
    ## Remediation ladder
    
    1. Restart Pi so package resources and final wrappers register in one fresh process.
    2. Reinstall `ca-pi` from the approved pinned Git tag. For project-local packages, inspect `/trust`
       and grant trust only if you accept that source; codeArbiter never grants it.
    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
    wrapper self-test with different spelling. MUST preserve the degraded active-dispatch diagnosis until
    supported-version real-host promotion/CI evidence closes PI-AC-28.
    
    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.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.