docs(6209): calibration stamp, after-write hook, usage seam, work log, duplicates, skill structure, tuning and rulebook routes, kind surface, prompt filter, moments, strict args, auth, lesson write path

Fourteen more test files: docstrings state the failure each guard defends
as a present-tense shape instead of the incident that found it, and issue,
milestone and rule numbers leave comments and assertion messages.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-21 21:35:44 -04:00
co-authored by Claude Opus 5.5
parent d0d278dcce
commit ba0b56018e
14 changed files with 90 additions and 104 deletions
+8 -9
View File
@@ -1,4 +1,4 @@
"""Every bundled skill keeps the shape Agent Skills can load well (#4398).
"""Every bundled skill keeps the shape Agent Skills can load well.
WHY THIS EXISTS
@@ -8,11 +8,10 @@ keep the SKILL.md body under 500 lines, split into reference files as it
nears that, and link each reference file ONE level deep from SKILL.md —
Claude may only preview a file reached through another reference file.
using-scribe reached 478 lines because every new practice lands there, the
same squeeze `_INSTRUCTIONS` was in before #4389. It was split: what matters
on most turns stays in SKILL.md, what matters at one moment (placing a rule,
a missed retrieval, starting a project) moved to files SKILL.md names with
the moment to open them. These tests keep that shape from quietly undoing
using-scribe grows because every new practice lands there. What matters on
most turns stays in SKILL.md; what matters at one moment (placing a rule, a
missed retrieval, starting a project) lives in files SKILL.md names with the
moment to open them. These tests keep that shape from quietly undoing
itself.
WHAT IT PINS
@@ -71,8 +70,8 @@ def test_every_skill_md_fits_its_budget():
SKILL_LINE_BUDGET)
assert not found, (
f"SKILL.md over {SKILL_LINE_BUDGET} lines: {found}. Move what matters at "
f"one moment into a reference file SKILL.md links with that moment "
f"(#4398), rather than raising the budget toward 500."
f"one moment into a reference file SKILL.md links with that moment, "
f"rather than raising the budget toward 500."
)
@@ -102,7 +101,7 @@ def test_long_reference_files_open_with_contents():
def test_the_guards_can_fail():
"""Rule 167: each guard bites on the failure it exists for."""
"""Each guard bites on the failure it exists for."""
assert over_budget({"s": "x\n" * 400}, SKILL_LINE_BUDGET) == ["s: 400 lines"]
assert unlinked("see [a](a.md)", ["a.md", "b.md"]) == ["b.md"]
assert nested({"a.md": "then [b](b.md)"}) == ["a.md → b.md"]