caveman-manage

Inspect Caveman Cloud experiment evidence and recommend lifecycle actions without executing mutations.

Updated Aug 20, 2026
One-click install
npx skills add https://github.com/bittlinkm/claude-setup --skill caveman-manage-bittlinkm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caveman-manage
Source: https://github.com/bittlinkm/claude-setup/tree/main/skills/caveman-manage
Command: npx skills add https://github.com/bittlinkm/claude-setup --skill caveman-manage-bittlinkm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing eval-gated experiments in Caveman Cloud requires reading evidence before any lifecycle change, but the current control API does not yet enforce transition and evidence gates atomically, so unsafe mutations must be blocked. ## Core Features & Use Cases - Evidence-first inspection: Load project context, experiment state, and results via MCP tools or the caveman CLI before any recommendation. - Gated recommendations: Propose exactly one action (start, approve, cancel, or rollback) only when evidence is complete and passing; report "evidence incomplete" otherwise. - Mutation blocking: Refuse to execute lifecycle commands because agent-generatable approval strings are not proof of human intent and server-side gates are not yet enforced. - Use Case: A user asks whether experiment 7f... can be promoted. The Skill reads its state and results, checks guardrails and quality evidence, then reports a supported recommendation while blocking execution. ## Quick Start Ask the assistant to review Caveman experiment 7f and recommend whether it should be approved based on its current evidence.

Frequently Asked Questions about caveman-manage

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

FAQPage Schema
How do I approve a Caveman Cloud experiment?

Approval requires complete passing evidence: quality results, all configured guardrails, and a safety class the current role may approve. The Skill recommends the approval but blocks execution until server-authoritative lifecycle and evidence gates ship.

How do I check experiment results in Caveman Cloud?

Use the MCP tools caveman_context and caveman_experiment_get with the results action, or the CLI commands caveman cloud experiments show and results. The Skill reports sample sizes, quality, guardrails, and evidence cost.

Can the agent execute experiment lifecycle changes directly?

No. The control API does not yet enforce transition and evidence gates atomically, so agent surfaces are read-only. Exact action strings are agent-generatable and are not treated as proof of human intent.

What happens when experiment evidence is incomplete?

The Skill reports "evidence incomplete" and does not propose approval. Absence of required fields is never treated as a pass, and unknown states or server errors fail closed with the exact cave_snake_code.

Does experiment lift count as verified savings?

No. Only active real traffic plus provider-causal, provider-complete ledger evidence can convert lift into verified_savings. Experiment evidence alone never changes verified savings.