Skip to content

fix(skill-creator): rename expectations to assertions in evals.json schema - #1679

Open
saeedseyfi wants to merge 1 commit into
anthropics:mainfrom
saeedseyfi:fix/evals-json-schema-assertions-field
Open

fix(skill-creator): rename expectations to assertions in evals.json schema#1679
saeedseyfi wants to merge 1 commit into
anthropics:mainfrom
saeedseyfi:fix/evals-json-schema-assertions-field

Conversation

@saeedseyfi

@saeedseyfi saeedseyfi commented Aug 27, 2026

Copy link
Copy Markdown

Summary

  • Renames expectations to assertions in the evals.json schema section of references/schemas.md (field name + bullet), matching the five references in SKILL.md
  • Leaves the grading.json section unchanged — expectations is correct there and is read by aggregate_benchmark.py and viewer.html

Fixes #587

Context

SKILL.md uses assertions consistently (lines 145, 161, 195, 201, 205), but schemas.md called the same evals.json field expectations. Nothing reads evals.json programmatically, so this never caused a crash — just inconsistent hand-written eval files when a reader followed one doc versus the other.

Test plan

  • Verify grading.json expectations field is unchanged (the aggregation script and viewer depend on it)
  • Confirm SKILL.md references to "assertions" now match the schema doc

…chema

The evals.json schema in schemas.md called the field "expectations",
but SKILL.md uses "assertions" in five places. This mismatch caused
inconsistent hand-written eval files. The grading.json section keeps
"expectations" unchanged — the aggregation script and viewer depend
on that exact field name.

Closes anthropics#1443
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.

Inconsistent terminology in skill-creator: assertions vs expectations

1 participant