Repository navigation
chore(docs): regenerate the agent skill references after merge instead of in every PR - #8807
Merged
leandrodamascena merged 1 commit intoNov 14, 2026
Merged
Conversation
|
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## develop #8807 +/- ##
========================================
Coverage 97.18% 97.18%
========================================
Files 323 323
Lines 16555 16555
Branches 1496 1496
========================================
Hits 16089 16089
Misses 326 326
Partials 140 140 ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
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.



Issue number:
closes #8806
Summary
Changes
The agent skill references stop being the contributor's problem:
tests/functional/test_agent_skill_references.pyis gone. A docs PR changes docs and nothing else; nobody has to know the generated folder exists.agent_skill_references.yml: on every push todevelopthat touchesdocs/,examples/or the generator, it regenerates the references and opens a PR through ourcreate-praction when anything changed. Same mechanism as the changelog rebuild; duplicates with the same title are closed by the action, so a burst of docs merges ends in one PR.:<version>in the examples, pointing to the installation page instead. That is what caused the drift after 3.40.0 (chore(ci): layer docs updatebumps:42to:43in 300 lines through a bot PR that never runs pre-commit), and an agent has no use for thirty ARNs that change weekly.installation.mdloses 300 lines of churn.make agent-skillstay for those who have them;AGENTS.mdsays they are optional now.User experience
Contributors: no more "Agent skill references are out of date" failures on PRs that only touch docs. Four of the ten PRs in 3.41.0 were failing on it.
Skill users: the installation reference points to the docs for ARNs instead of carrying a table that is one release behind.
Verification
Generator run and
--checkclean, ruff clean on the script, workflow YAML parsed, references regenerated with this generator. The workflow reuses the pinned checkout and thecreate-praction fromreusable_publish_changelog.yml, so the permissions and the no-changes early exit are the ones already in use. Written with an AI assistant; I ran everything above myself.By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.