- Checks and downloadable reports: copy
skill-checks.ymlto.github/workflows/skill-checks.yml. Setpathsto your skill roots and choosemin-score(default 70). - Hosted reports and PR comments: also copy
publish-skill-reports.ymlto.github/workflows/and complete the one-time setup below.
The workflow and image pins are already filled in. Both templates use GitHub's automatic token; no personal token or model key is needed for the default checks. Your organization must allow the referenced actions and the provided permissions.
- Enable Settings → Pages → Source: GitHub Actions. Reports can include source excerpts; a private repository does not automatically make its Pages site private. Use scan artifacts if hosting is unsuitable. Coordinate any existing Pages site first.
- Initialize a new
gh-pageshistory branch with.nojekyllandhistory.jsoncontaining[]. Preserve existing site content and history. - Set
YOUR_REPORT_BASE_URLin the publisher template to your Pages URL. - Uncomment
id-token: writeunderpermissionsinskill-checks.ymlfor signed execution receipts. After customizing the scan file, rungit hash-object .github/workflows/skill-checks.ymland put the result intrusted-caller-blobs. Refresh this value after every scan-file edit. - Merge both files into your default branch, keeping the supplied scan filename, workflow name and artifact name. The publisher already declares its required permissions.
New eligible PR scans trigger publication automatically. After successful deployment, the bot creates or updates one comment on the current, open, same-repository PR. Fork PR comments and comment-only operation are not supported by this publisher.
Without the signing permission, ordinary scans and downloadable reports still run; hosting is skipped. Commit the setup and trigger a new scan; rerunning an old job keeps its original workflow.
For GitLab, merge gitlab-skill-checks.yml into your root .gitlab-ci.yml and set SKILL_EVAL_PATHS. Its rules must remain in the root file to enable merge-request pipelines.