open/llm-ingestion-okf
1
0
Fork 0
Code Issues Releases 1 Activity

fix(skill): regenerate skills/okf-consume from the golden bundle it ships a payload for

Browse source 
The hand-filled skill predated `okf skill`, declared no bundle identity,
and was refused by the checker it tells its reader to run, against the
payload shipped beside it:

  NOT conformant: 16 rules over 3 excerpts and 0 withheld entries, 1 findings
    bundle_mismatch: the skill declares no readable bundle identity, ...

It is now the generator's output for
examples/ingest-golden-segmented-okf-v0-2/expected-bundle, the bundle the
payload always came from:

  conformant: 16 rules over 3 excerpts and 0 withheld entries, 0 findings

The payload's bytes do not move. --force and --example-question are both
required: without the question the payload is a different one (spent
2125 -> 1420, delivered 3 -> 2, withheld 0 -> 1) and the byte test fails.
`okf skill` writes the bundle root and the skill path absolute when --out
is not under .claude/skills/, so the checkout prefix is stripped in one
mechanical step that a test holds; the generator is unchanged.

The frontmatter name becomes b-golden-segmented-okf-v0-2-consume. Claude
Code takes a project skill's command from its directory, which stays
okf-consume, and nothing in this repository named the skill by name.
references/README.md is rewritten by hand with the full regeneration
command; living prose in README, CLAUDE.md, the test comment and the
skill.py docstring is corrected, dated journals are left as written.

Report: docs/2026-09-11-k3-runde18-konsumskillen-regenerert.md

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-09-11 02:21:35 +02:00
commit 6858ff2d35
8 changed files with 397 additions and 164 deletions
Download patch file Download diff file Expand all files Collapse all files

17
README.md
View file

@ -502,12 +502,17 @@ Check any payload against the skill that will read it:
python3 tools/okf_contract_check.py --skill skills/okf-consume/SKILL.md --payload payload.json
```
`skills/okf-consume/` is the first instantiated consumption skill: a filled copy
of `skills/okf-consume-template/` naming this pre-pass, with every per-corpus
hole replaced by a measured value. Measured 2026-09-07 on a 629-concept bundle,
hit@8 was **5 of 6** questions at rank 1 against a chance baseline of **1.35 of
6** — with one control that failed, and both are in
`docs/2026-09-07-okf-konsumskill-maaling.md` with the honesty limits stated.
`skills/okf-consume/` is an instantiated consumption skill generated by
`okf skill` from the golden bundle this repository ships,
`examples/ingest-golden-segmented-okf-v0-2/expected-bundle`, together with the
payload that proves it: `okf check` on the pair is conformant with 0 findings.
It is regenerated with the command in `skills/okf-consume/references/README.md`
rather than edited, and a test holds the shipped bytes to the generator's. Its
numbers describe that three-concept bundle and nothing larger. The measurement
behind the consumption skill as a form — hit@8 **5 of 6** questions at rank 1
on a 629-concept bundle against a chance baseline of **1.35 of 6**, with one
control that failed — is `docs/2026-09-07-okf-konsumskill-maaling.md`; the copy
filled by hand for that corpus cannot ship and is no longer the one here.
## Consume in Claude Code