Okra

Okra packages the reverse-tornado-okr skill: a workflow for turning a goal into a measured, self-correcting OKR loop with an anti-goal guardrail.

The repo is set up as both a skill development workspace and a releasable plugin:

• Claude Code plugin manifest: .claude-plugin/plugin.json
• Codex plugin manifest: .codex-plugin/plugin.json
• Canonical skill: skills/reverse-tornado-okr/SKILL.md
• Blindbox evals: evals/blindbox/
• Review prompt: evals/review/skill-review.md
• Runner: scripts/okr-runner.py

What The Skill Does

Use the skill when a user is setting OKRs, defining measurable goals, planning a roadmap toward a metric, or delegating goal execution while keeping human control of direction.

It produces:

• objective and target metric
• measured anti-goal and guardrail type
• DKR/CKR/PKR decomposition
• three-point anti-goal evaluation
• escalation flags and human-owned frame
• operating-loop cadence for recurring or automated runs
• OKRA learning memory for recurring project contexts

For real-life runs, the skill requires metric freshness contracts, heartbeat cadence, lag windows, flag lifecycle, action envelope, and idempotent storage.

Claude Code

Validate the plugin locally:

claude plugin validate . --strict
claude plugin tag --dry-run .

Install from GitHub after the repository is published:

claude plugin marketplace add lagz0ne/okra
claude plugin install okra@okra-marketplace

The unqualified claude plugin install okra also works when no other configured marketplace exposes an okra plugin.

Codex

Validate the skill and eval harness:

scripts/validate-skills.sh
scripts/run-blindbox.sh --dry-run --agent both

The repo-local skill links are:

.claude/skills/reverse-tornado-okr -> ../../skills/reverse-tornado-okr
.codex/skills/reverse-tornado-okr -> ../../skills/reverse-tornado-okr

Real Eval

Run a real isolated eval when Claude/Codex credentials are available:

CODEX_MODEL=<codex-model> ANTHROPIC_MODEL=<claude-model> \
scripts/run-blindbox.sh --agent both --case real-life-operations

For the cross-run learning-memory case:

CODEX_MODEL=<codex-model> ANTHROPIC_MODEL=<claude-model> \
scripts/run-blindbox.sh --agent both --case okra-learning-memory

The runner copies a fixture into .runs/, injects the skill into a disposable workspace, launches the selected agent through bwrap, and preserves prompts, logs, outputs, hashes, and check results. Writable agent scratch lives under each run's runtime/ directory, is checked for post-run cleanup, and is excluded from preserved-artifact credential scans after cleanup. If cleanup fails, the leftover runtime/ tree is scanned and hashed by the cleanup check.

Review

Before releasing skill or harness changes, run:

scripts/review-skill.sh --agent both

Review outputs land under .runs/review/. In diff mode, untracked file contents are not embedded in the Claude diff context; reviewers read listed safe untracked paths directly when needed.

Release

The plugin version lives in both manifests:

• .claude-plugin/plugin.json
• .codex-plugin/plugin.json

For a Claude Code release tag:

claude plugin validate . --strict
claude plugin tag .
git push origin main --tags

License

MIT