Minimal domain skill

Skill mataeil/OODA-loop/templates/minimal-domain-skill

Autonomous operations layer for Claude Code — opens small reviewable PRs for your live side project and re-orients from which ones you merge or reject. HALT file + hard cost cap; you stay in command.

Install

npx -y skills add mataeil/OODA-loop --skill minimal-domain-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Minimal example Observe-phase domain skill. Checks disk usage and records it. Copy this as a starting point for your own domain.

SKILL.md

2.0 KB, as published. Nobody here has run it

/scan-disk — Minimal Domain Skill Example

The smallest useful Observe skill: it reads disk usage, records a baseline, and emits an alert when usage crosses a learned threshold. Use it as a 30-line template for your own domain. Every skill starts with a HALT check.

Step 0: Safety

ls agent/safety/HALT 2>/dev/null && echo "HALT_ACTIVE" || echo "HALT_INACTIVE"

If HALT is active, print the reason and stop immediately.

Step 1: Observe

df -P / | tail -1 | awk '{print $5}' | tr -d '%'   # → integer percent used

Load the lens (agent/state/disk_usage/lens.json) if present. Use its learned_thresholds for warn_pct if it has one; otherwise default warn_pct = 85.

Step 2: Record + alert

Write agent/state/disk_usage/state.json:

{
  "schema_version": "1.0.0",
  "last_run": "<now ISO-8601>",
  "status": "healthy",            // healthy | degraded | critical
  "metrics": { "used_pct": 73 },
  "alerts": []                    // e.g. ["disk 91% > warn_pct 85"] when crossed
}

Set status: "degraded" and add an alert when used_pct >= warn_pct; "critical" at >= 95. The evolve engine reads status/alerts during Observe and factors them into scoring.

Adaptive Lens (optional but recommended)

evolve's Step 5-E initializes and updates agent/state/disk_usage/lens.json automatically. To participate, just emit consistent metrics/alerts; the engine learns a per-host warn_pct over time (raising it on repeated false positives, lowering it after real incidents). You don't write the lens yourself.