The reference end-to-end pass: fixed database query → local analysis → versioned artifacts carrying lineage → an evidence package that verifies in a clean environment.
Use it as the first-run demonstration, as a benchmark case (the inputs are fixed so two runs are comparable), or whenever a result has to be handed to someone who was not there when it ran.
Verify an exported package the way a recipient would, with no daemon:
openai4s verify-package <session>.openai4s-session.zip
A pass means the package is intact, not that it is authentic — see
openai4s/evidence.py for exactly what
verification does and does not establish.
The recipe itself is in SKILL.md.
A Skill is a directory of files, so installing one is copying that directory
somewhere an agent looks. With Node 18+ and git on PATH (npm resolves a
github: spec through it), and nothing cloned:
npx github:PKU-YuanGroup/OpenAI4S install evidence-walkthrough --target claude
--target claude writes to ~/.claude/skills, claude-project to
./.claude/skills, openai4s to <data_dir>/user-skills, and --dir <path>
to anywhere you name. The resolved absolute path is printed before anything is
written there, and --dry-run stops at that plan. A reinstall refuses to
overwrite a copy you have edited or one it did not install, and uninstall
removes only the files it wrote. For a recipe included in the npm release,
npx @pku-yuangroup/openai4s-skills install evidence-walkthrough --target claude
installs the published copy. The npm catalog can differ from this repository.
Without Node, take the directory itself — and turn it into a .zip if an upload
field wants one. The tarball is the whole repository (over 100 MB), and the pipe
is a POSIX shell recipe (macOS, Linux, WSL) that extracts only this directory:
curl -L https://codeload.github.com/PKU-YuanGroup/OpenAI4S/tar.gz/refs/heads/main \
| tar -xz --strip-components=2 OpenAI4S-main/skills/evidence-walkthrough
python3 -m zipfile -c evidence-walkthrough.zip evidence-walkthrough
The click-through form of that same download is the
repository zip,
which is also the route to take on Windows: extract it and copy
skills/evidence-walkthrough/ out
(unzip main.zip 'OpenAI4S-main/skills/evidence-walkthrough/*' unpacks only
that directory). If you already run OpenAI4S there is nothing to install — the
wheel ships every bundled Skill, and a bundled Skill takes precedence over a
same-named copy in <data_dir>/user-skills. Targets, provenance, and what the
installer refuses to do:
tools/skills-installer/.