mataeil/OODA-loop / templates/minimal-domain-skill
scan-disk
VerifiedMinimal example Observe-phase domain skill. Checks disk usage and records it. Copy this as a starting point for your own domain.
SKILL.md
View on GitHub---
name: scan-disk
description: Minimal example Observe-phase domain skill. Checks disk usage and records it. Copy this as a starting point for your own domain.
ooda_phase: observe
version: "1.0.0"
input:
files:
- config.json
- "agent/state/disk_usage/lens.json"
config_keys:
- "domains.disk_usage"
output:
files:
- agent/state/disk_usage/state.json
prs: none
safety:
halt_check: true
read_only: true
domains:
- disk_usage
chain_triggers: []
---
# /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
```bash
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
```bash
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`:
```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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |