Skip to content

fix(writing): close agent-instructions eval leftovers - #54

Merged
a1exk-dev merged 2 commits into
developfrom
feature/agent-instructions-eval-fixes
Oct 19, 2026
Merged

a1exk-dev merged 2 commits into
developfrom
feature/agent-instructions-eval-fixes

Conversation

@a1exk-dev

Copy link
Copy Markdown
Owner

Summary

Closes the #17 eval leftovers for the agent-instructions Skill. The rules stay in the Skill files, and grader.md points to them.

  • ste-rules.md: word-count rules (colons, multi-word nouns, headings, code blocks) and a table of count examples.
  • review.md: numbered counts near the limit, a file copy and diff to find the changed sections, no change to a saved report, and one report per message (no copy or git call in it).
  • SKILL.md: a finding comes only from a reviewer report; a new conflict-table row for the glossary/MEMORY.md entry format.
  • agent-skills-spec.md: a description that gives an instruction is procedural text.
  • plain-language-checks.md, technical-terms.md: glossary words in lowercase; when a colon stops a sentence.
  • Tests: countWords in eval-lib.ts, tested against the examples in ste-rules.md. grader.md points to the Skill sections. Test 5 gives an action for the Guidance line, and [5.1] names the 3 lines.

Evidence

  • Before (matrix-2, 208615c): 112/115. Failures: test 4 [4.1], test 5 [5.1], test 10 [10.2].
    After (matrix-3, 1d123ee): 115/115. Claude Code 2.1.302, one run per test, one fresh grader per test.
  • docker compose run --rm bun run check exits 0. A changed example in ste-rules.md makes the countWords test fail.
  • Not shown: pass rates. Each test ran once.

Merge Danger

Door: two-way

Blast Radius: skill-users

Projects that install the agent-instructions Skill get the new rules once they reach main.

Refs: #17

…eval matrix

- review.md: make the round copy in its own tool call, and put no other
  tool call in the message that saves a report.
- SKILL.md: add the entry-format vs "do not omit words" case to the
  conflict table.
- agent-skills-spec.md: a description that gives an instruction is
  procedural text (20-word limit).
- evals.json: give test 5 an action for the Guidance line, and make
  [5.1] name the 3 lines it checks.

Refs: #17
@a1exk-dev
a1exk-dev merged commit 344d71d into develop Oct 19, 2026
4 checks passed
@a1exk-dev
a1exk-dev deleted the feature/agent-instructions-eval-fixes branch October 19, 2026 22:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant