Make .agents/skills the canonical agent-skills home#68143
Merged
Conversation
potiuk
requested review from
amoghrajesh,
ashb,
bugraoz93,
choo121600,
gopidesupavan,
jason810496,
jedcunningham,
jscheffl,
kaxil,
shahar1 and
vincbeck
as code owners
boring-cyborg
Bot
added
area:dev-tools
backport-to-v3-2-test
Adopt the apache-steward apache#460 "canonical .agents/skills, relay other agents into it" model and move every agent skill — the repo's own and the magpie framework ones — to a single canonical home so they are discoverable by the whole shared-path agent cluster (Codex, Cursor, Gemini CLI, Copilot, OpenCode, …) alongside Claude Code and GitHub: - `.agents/skills/<skill>` is the canonical entry; `.github/skills/` and `.claude/skills/` carry per-skill relay symlinks pointing into it. - Relocate the repo's own skills (`aip-user-stories`, `airflow-translations`, `prepare-providers-documentation`) and the committed `magpie-setup` bootstrap copy from `.github/skills/` to `.agents/skills/`, with relays from `.github`/`.claude`. - Refresh the committed `magpie-setup` bootstrap from apache/airflow-steward main (the apache#460 canonical-.agents model; `conventions.md` merged into `agents.md`). Re-point the prek hooks and tooling that anchored on `.github/skills/...` at the new `.agents/` location — full/short license headers, blacken-docs, codespell, inclusive-language, markdownlint, lychee, the translation-namespace sync trigger, and the hardcoded SKILL.md path in `sync_translation_namespaces.py`. prek skips symlinks, so only the real files (now under `.agents/`) are processed. Add `.gitignore` negations so the `.claude/skills/` relays stay tracked, and update the provider-release doc path reference.
potiuk
force-pushed
the
agents-skills-canonical
branch
from
37e0ffe to
5f2548e
Compare
jscheffl
approved these changes
Jun 7, 2026
Member
Author
|
Flaky tests fixed elsewhere. |
Contributor
Backport failed to create: v3-2-test. View the failure log Run detailsNote: As of Merging PRs targeted for Airflow 3.X In matter of doubt please ask in #release-management Slack channel.
You can attempt to backport this manually by running: cherry_picker 942de38 v3-2-testThis should apply the commit to the v3-2-test branch and leave the commit in conflict state marking After you have resolved the conflicts, you can continue the backport process by running: cherry_picker --continueIf you don't have cherry-picker installed, see the installation guide. |
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
2 participants
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.
Adopts the apache-steward #460 model —
.agents/skills/as the singlecanonical home for agent skills, with
.github/skills/and.claude/skills/carrying thin per-skill relay symlinks into it. Thismakes every skill discoverable by the shared-path agent cluster (Codex,
Cursor, Gemini CLI, Copilot, OpenCode, …) alongside Claude Code and
GitHub, instead of being tied to
.github/skills/.What changed:
aip-user-stories,airflow-translations,prepare-providers-documentation) and the committedmagpie-setupbootstrap from
.github/skills/to.agents/skills/, with relays from.githuband.claude(history preserved via git renames).magpie-setupbootstrap from apache/airflow-stewardmain(the Fix issue #459 - mysql error 2014 #460 canonical-.agentsmodel;conventions.mdfolded intoagents.md)..github/skills/...at the new
.agents/location — license headers, blacken-docs, codespell,inclusive-language, markdownlint, lychee, the translation-namespace sync
trigger, and the hardcoded path in
sync_translation_namespaces.py. prekskips symlinks, so only the real files (now under
.agents/) are processed..gitignorenegations so the.claude/skills/relays stay tracked, and aprovider-release doc path reference update.
No runtime/user-facing Airflow behaviour changes — this is agent-skills
plumbing and CI-config only.
Was generative AI tooling used to co-author this PR?
Generated-by: Claude Code (Opus 4.8 (1M context)) following the guidelines