docs(education): add writing-safe-skills page as step 5 in the learning progression#755
Conversation
…ng progression Insert a new authoring-focused stage between "your first skill" (step 4) and "eval-driven development" (now step 6). The page covers five copy-ready patterns that hold PRINCIPLE 0 (data-not-instructions) and PRINCIPLE 1 (sandbox) in every skill body: explicit read/act boundary in step headings, the injection-flag idiom, data-only write steps, routing private bytes through the Privacy-LLM gate, and draft-before-post confirmation. Includes an annotated end-to-end example, a "Check your understanding" block, and forward/back cross-links. Updates the progression table in README.md (steps 5→6→7→8→9) and fixes the step references in your-first-skill.md, eval-driven-development.md, and agentic-work.md. Generated-by: Claude (claude-sonnet-4-6)
a3cb680 to
f0c3129
Compare
potiuk
left a comment
There was a problem hiding this comment.
Reviewed and merging — the progression renumbering is done correctly and consistently: writing-safe-skills slots in as step 5 and every page carrying a hardcoded step number (README, your-first-skill, eval-driven-development, agentic-work, and the new page) is updated to match. Good new page, too — solid coverage of the data-not-instructions / sandbox / Privacy-LLM authoring patterns.
I pushed a small fixup (you're still the commit author): the prose recaps at the top of english-as-code.md and contributing.md now include the new step ("…written a skill, learned to keep it safe, tested it with evals…" and "…how to write a skill, keep it safe, and test it with evals…"), so those "by now you have…" summaries stay complete. Those two pages carry no step numbers, so nothing else in them needed touching.
One thing from my first read that turned out to be a non-issue: the ## Step 1 — Fetch and redact line is inside a fenced ```markdown code block (it's a skill example), so it's correctly not a real TOC entry — no change needed there.
All green. Thanks!
Summary
Insert a new authoring-focused stage between "your first skill" (step 4) and "eval-driven development" (now step 6). The page covers five copy-ready patterns that hold PRINCIPLE 0 (data-not-instructions) and PRINCIPLE 1 (sandbox) in every skill body: explicit read/act boundary in step headings, the injection-flag idiom, data-only write steps, routing private bytes through the Privacy-LLM gate, and draft-before-post confirmation. Includes an annotated end-to-end example, a "Check your understanding" block, and forward/back cross-links. Updates the progression table in README.md (steps 5→6→7→8→9) and fixes the step references in your-first-skill.md, eval-driven-development.md, and agentic-work.md.
Generated-by: Claude (claude-sonnet-4-6)
Type of change
.claude/skills/<name>/) — eval fixtures updated belowtools/<system>/*.md)tools/*/withpyproject.toml)docs/,README.md,CONTRIBUTING.md)projects/_template/)prek, workflows, validators)Test plan
prek run --all-filespassesuv run pytest/ruff check/mypypasses(
PYTHONPATH=tools/skill-evals/src python3 -m skill_evals.runner tools/skill-evals/evals/<skill>/)(a regression test for the bug fixed / the behaviour added — see CONTRIBUTING.md)