open/voyage
1
0
Fork 0
Code Issues Releases 13 Activity

feat(skills): voyage:annotating, the operator-annotation loop as one skill (order B)

Browse source 
The three producing commands name voyage:annotating where they build the page; the description of the page and the freehand revision left them. The skill: the person writes every note, Fix/Change edit only the quoted text, a Question is answered and changes nothing, the approval an edit costs is said before the edit, the page is rebuilt. Research documents on request (decision 62). Red baseline 3 runs per scenario without and with the skill; six eval cases; 11 pins.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-10-19 18:36:00 +02:00
commit 843897ae33
Signed by: ktg
SSH key fingerprint: SHA256:JakMjO6FTBBzN0Bhfj9saOoEjaFxlSdYuZQQpM/lF9Q
25 changed files with 550 additions and 46 deletions
Download patch file Download diff file Expand all files Collapse all files

7
docs/skills-authoring.md
View file

@ -120,12 +120,15 @@ The pressure itself did not break the control in any run. The skills target what
## Adding a skill: checklist
1. Run the red baseline; keep the transcripts' findings.
1. Run the red baseline; keep the transcripts' findings. Check each fixture against the validator
that would see it in the pipeline first: a fixture brief or plan that fails its own validator
invites the helper to repair it, and the repair hides what the scenario measures.
2. Write `skills/<name>/SKILL.md` in the S1 form; run `node lib/skills/skill-lint.mjs`.
3. Write the cases (3 / 2 / 1) with `from=` tags; run `node lib/skills/routing.mjs`.
4. Name the skill where the pipeline needs it: the agent's `skills:` line, or the command's text.
5. Run the scenarios with the skill; record both arms.
6. Add one row to `## Skills` in `README.md` and `CLAUDE.md`.
6. Add one row to `## Skills` in `README.md` and `CLAUDE.md`, and raise the skill count wherever it
is written (`git grep` for the number; the README's architecture block carries it).
## Credits