iii-hq/skills-and-validation
Validate worker or docs skill artifacts via iii-skill-check
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jul 9, 2026
- License
- None
Pinned Snippet
uses: iii-hq/skills-and-validation@21bb901c16edbcbb824c5852b659c3be03822d29 # v0.4.29tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| version | Pinned validator release to download (e.g. "0.1.5", "0.1", or "latest"). Defaults to "latest" — track the most recent stable release. Pin via this input or via the `uses:`-line ref (`@v0.1.5`) when you want reproducibility. | no | latest |
| config-path | Path to the `.skill-check.yaml` that controls this run, relative to $GITHUB_WORKSPACE. Defaults to `.skill-check.yaml` at the workspace root. Set this when validating multiple modes in one repo via a matrix strategy — each matrix entry points at its own config and the sticky PR comment is keyed off the path so runs don't clobber each other. | — | .skill-check.yaml |
| workers-glob | Worker mode: glob of worker manifests to verify, relative to $GITHUB_WORKSPACE. Ignored when the controlling `.skill-check.yaml` declares `mode: docs`. | — | */iii.worker.yaml |
| docs-glob | Docs mode: glob(s) of doc files to verify, relative to $GITHUB_WORKSPACE. Space-separated patterns are supported. Ignored when the controlling `.skill-check.yaml` declares `mode: worker`. The binary additionally filters per-file against `docs.include` / `docs.exclude` from the config, so a permissive glob can't make the renderer attempt non-doc files. | — | **/*.md **/*.mdx |
| layers | Comma-separated subset of layers to run (structure,vale,ai) | — | structure,vale,ai |
| vale-version | Pinned Vale version | — | 3.14.1 |
| anthropic-api-key | Anthropic API key for the AI layer (omit to skip AI) | no | — |
| write | Auto-render and commit the rendered diff back to the PR branch when sources drift from rendered output. Worker mode commits per-worker README.md / skill.md / skills/; docs mode commits `<source>.skill.md` siblings only. Requires `contents: write`. | — | false |
| scope | `all` (default) | `pr-diff`. Controls which artifacts get verified. With `pr-diff`, on `pull_request` events only files changed in the PR (against the merge base) are validated; in worker mode, a changed file under `<worker-dir>/` validates the whole worker. A diff that changes verdict-affecting `.skill-check.yaml` keys (rules, model, system_prompt, ai_check, mode) falls back to full scan; a change confined to `docs.include` / `docs.exclude` stays scoped. On `push` events `pr-diff` also falls back to full scan. | — | all |
| target-branch | Branch to push the auto-render commit to when `write: true` and drift is present. Defaults to the empty string; the action then falls back to `$GITHUB_HEAD_REF` (set by the runner on `pull_request` events). Set this explicitly when invoking the action from `issue_comment` (e.g. the recheck-on-comment reusable workflow) — in that context `$GITHUB_HEAD_REF` is unset and the push would have no target. | — | "" |
Outputs
no outputs