ci: run the toolkit job when a skill or agent doc changes - #898
Open
gabriel-lisboa-azion wants to merge 1 commit into
Open
ci: run the toolkit job when a skill or agent doc changes#898gabriel-lisboa-azion wants to merge 1 commit into
gabriel-lisboa-azion wants to merge 1 commit into
Conversation
isaque-bock-azion
previously approved these changes
Aug 14, 2026
gabriel-lisboa-azion
force-pushed
the
ci/toolkit-filter-skill-agent-docs
branch
from
August 17, 2026 12:35
23ee875 to
4d44f00
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
toolkitjob runs thedoc-standardsratchet (check-authoring-docs.mjs), the only CI gate for.claude/skills/**and.claude/agents/**— but neither path was in the job's change filter, so a skill- or agent-only PR skipped it. The gate was skipping exactly the PRs it exists to check (seen on docs: rewrite add-animation for the CSS-first theme #897, which changes oneSKILL.mdand ran nothing but CodeQL).toolkitfilter.governance.ymlis the only workflow that runs this ratchet, so nothing else covered the gap; consumer skills underpackages/webkit/cli-templates/claude/were already covered bypackages/webkit/**.authoring-docs.md's claim that the ratchet "fails on any introduced key even from an editor that never ran the hook" held only for the write-time hook on these two populations.How to test
.claude/skills/*/SKILL.md(or.claude/agents/*.md) and nothing else, then open a PR. Expected:Detect Changessetstoolkit=trueandAdoption Toolkit (tests + catalog drift)runs instead of reportingskipping.Skill/agent doc standards ratchetstep executes. Locally the equivalent ispnpm --filter @aziontech/webkit run doc-standards— currently✓ doc-standards ratchet: 7 known violations, 0 new.scope:orenforced_by:) and push. Expected: the step fails with the new violation key, where before the whole job was skipped.Notes
ci).doc-standards-baseline.json.