docs(platform-ops): rename model-caps endpoint to cap.json

[indykish]

Summary

The public model catalogue endpoint was renamed model-caps.json → cap.json in usezombie/usezombie#373 (old path now 404s, no alias). This corrects the two stale references in the usezombie-install-platform-ops skill:

• references/self-managed-handoff.md — the example URL and "model-caps endpoint" prose.
• SKILL.md — the "Calling the model-caps endpoint directly" anti-pattern row.

Prose-only; runtime is unaffected (the skill resolves provider values from doctor, not this endpoint).

Note

The chore/agent-terminology branch carries the same prose and will pick this up when it reconciles with main.

🤖 Generated with Claude Code

Greptile Summary

Renames the stale model-caps.json endpoint reference to cap.json across two documentation files following the upstream API rename in usezombie/usezombie#373.

• SKILL.md: Updates the "Common Mistakes" anti-pattern row label from "Calling the model-caps endpoint directly" to "Calling the cap.json endpoint directly."
• references/self-managed-handoff.md: Corrects the example URL (model-caps.json → cap.json) and the surrounding prose to match.

Confidence Score: 5/5

Safe to merge — purely documentation updates with no runtime impact.

Both changes are prose-only: the endpoint name and URL are corrected in exactly the two places cited in the PR description, and a repo-wide search confirms no remaining model-caps references exist.

No files require special attention.

Important Files Changed

Filename	Overview
usezombie-install-platform-ops/SKILL.md	One-word rename in the "Common Mistakes" table: "model-caps endpoint" → "cap.json endpoint". No logic changes.
usezombie-install-platform-ops/references/self-managed-handoff.md	Updates the example URL path from model-caps.json to cap.json and aligns the surrounding prose to match. No logic changes.

Sequence Diagram

sequenceDiagram
    participant Agent as AI Agent / Skill
    participant Doctor as zombiectl doctor
    participant API as api.usezombie.com

    Agent->>Doctor: Run doctor (readiness check)
    Doctor-->>Agent: tenant_provider block (resolved model + cap)
    Note over Agent,Doctor: Values already resolved — no extra network call needed

    alt "Anti-pattern (documented mistake #6)"
        Agent->>API: GET /_um/.../cap.json
        API-->>Agent: Model list with context caps
        Note over Agent,API: Redundant — doctor already provided these values
    end

Loading

_{Reviews (1): Last reviewed commit: "docs(platform-ops): rename model-caps en..." | Re-trigger Greptile}