Skip to content

docs(skill-evals): add --cli to workflow-security-audit and license-compliance-audit READMEs - #1134

Merged
onlyarnav merged 1 commit into
apache:mainfrom
AmirF194:fix/943-eval-readme-cli-flag
Sep 1, 2026
Merged

docs(skill-evals): add --cli to workflow-security-audit and license-compliance-audit READMEs#1134
onlyarnav merged 1 commit into
apache:mainfrom
AmirF194:fix/943-eval-readme-cli-flag

Conversation

@AmirF194

Copy link
Copy Markdown
Contributor

Summary

  • Add --cli "claude -p" to the documented run commands in the
    workflow-security-audit and license-compliance-audit eval READMEs.
  • Without it the runner has no model to drive, so both suites' prose and
    structured cases report MANUAL instead of PASS/FAIL when the README
    is followed as written.

Type of change

  • Documentation (docs/, README.md, CONTRIBUTING.md)

Test plan

  • PYTHONPATH=tools/skill-evals/src python3 -m skill_evals.runner tools/skill-evals/evals/workflow-security-audit/step-scope-selection/fixtures/case-3-injection-in-scope-input (the pre-fix, documented command): prints the prompt and expected JSON, no PASS/FAIL/MANUAL grading at all, since print mode has no model to compare against.
  • Same case with --cli pointed at a stub script that echoes the exact expected.json: PASS step-scope-selection/case-3-injection-in-scope-input, confirming the --cli flag is what drives grading. I don't have a claude CLI or API credentials in this environment, so I could not run it against the real model; the stub proves the harness wiring, not a live grade.
  • prek run --all-files (add-license-headers, check-placeholders, markdownlint-cli2, typos) passes on both files. lychee is unaffected: the diff adds no links.
  • Both suites already use exact-match expected.json (enums/booleans only), the same shape onboarding-concierge's README documents as gradable via --cli with no MANUAL fallback.

RFC-AI-0004 compliance

Not applicable: doc-only change to eval instructions, no skill/tool behavior changed.

Linked issues

Fixes #943

…ompliance-audit READMEs

Both READMEs document run commands without --cli, so following them
verbatim drives the runner in print mode: prose and structured cases
report MANUAL instead of PASS/FAIL. Both suites use exact-match
expected.json (enums/booleans), the same shape onboarding-concierge
documents as gradable via --cli, so this is a doc gap, not intended
behavior.

Generated-by: Claude Code (Sonnet 5)
Signed-off-by: Amir Fathi <amirfathi.me@gmail.com>

@onlyarnav onlyarnav left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

  • Syntax matches sibling eval suites in tools/skill-evals/evals/.

Ready to merge!

@onlyarnav
onlyarnav merged commit a1cff44 into apache:main Sep 1, 2026
9 checks passed
@AmirF194

AmirF194 commented Sep 2, 2026

Copy link
Copy Markdown
Contributor Author

Good catch checking it against the sibling suites, glad it lines up.

@AmirF194
AmirF194 deleted the fix/943-eval-readme-cli-flag branch September 2, 2026 05:22
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.

Add --cli to two eval READMEs so their suites actually grade

2 participants