Enriching okf blueprints
Skill vamsiramakrishnan/ge-agent-factory/skills/enriching-okf-blueprints
Improve GE Agent Factory OKF blueprints after quality classification by adding serious evals, fixtures, multi-turn coverage, trajectory assertions, state assertions, adversarial tests, and domain invariant coverage. Use when working on OKF catalog specs, eval coverage, blueprint maturity, or enrichment shards.From its SKILL.md
npx -y skills add vamsiramakrishnan/ge-agent-factory --skill enriching-okf-blueprintsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 3 stars3 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.
SKILL.md
2.5 KB, as published. Nobody here has run it
Enriching OKF Blueprints
You improve OKF blueprints through a classification-driven, patch-first enrichment workflow.
Hard rules
- Do not invent source systems, tools, entities, fields, or authority that are not in the OKF contract.
- Do not mark a blueprint proven manually.
- Do not edit generated docs directly.
- Do not bypass proof gates or hash-bound proof checks.
- Do not add generic evals.
- Every new eval must have deterministic assertions.
- Every action-tool eval must include
expected_state_deltaorexpected_no_mutation. - Every high-risk or regulated spec must include adversarial and multi-turn coverage.
- Every new fixture must be referentially consistent.
- If domain expertise is insufficient, add
needs_expert_reviewrather than fabricating certainty.
Workflow
- Read the shard manifest.
- Run preflight commands.
- Inspect each OKF spec and matching domain pack.
- Generate reviewable patch JSON with
ge okf enrich generate. - Dry-run apply with
ge okf enrich apply --patch <patch>. - Apply patches only after reviewing allowed files and references.
- Run
ge okf eval verify --spec <id>. - Run
ge okf quality audit --spec <id> --fail-under <threshold>. - Run proof commands when locally available.
- Summarize changed specs, status movement, blockers, and command output.
Harness notes
- Codex: run one shard per task/worktree and commit only source OKF/eval/fixture files plus
.enrichmentreports. - Claude Code: use this skill with the shard prompt generated by
ge okf enrich prompt --harness claude. - Antigravity SDK: submit the generated prompt as a
harness.runtask, with this skill available in the workspace skill registry.
Scripts
scripts/apply-shard.mjsgenerates and applies reviewable enrichment patches for every spec in a shard.scripts/run-quality-audit.mjsrunsge okf quality auditfor one spec or the full catalog.scripts/verify-shard.mjsverifies evals and quality thresholds for every spec in a shard.
Read references/enrichment-rules.md when you need the exact patch/eval requirements.
Read references/example-session.md for a worked shard enrichment loop.