GSoC 2026 PoC Agent Skills executable document system with context detection#64008
Draft
Pranaykarvi wants to merge 6 commits intoapache:mainfrom
Draft
GSoC 2026 PoC Agent Skills executable document system with context detection#64008Pranaykarvi wants to merge 6 commits intoapache:mainfrom
Pranaykarvi wants to merge 6 commits intoapache:mainfrom
Conversation
…and DX report - Add --check flag to extractor for CI drift detection - Add check-agent-skills-drift pre-commit hook - Add skill_graph.py with dependency tree and cycle detection - Add skill_graph.json machine-readable graph output - Add DX_REPORT.md documenting measurable impact of Agent Skills - Add 6 new tests (11 total now) Addresses Jason's ask to verify actual developer experience impact. Related: apache#62500
- Add breeze_context.py with get_context() and get_command() runtime API - Add validate_skills.py with full schema validation and duplicate detection - Add query_skills.py for skill discovery by context/category/chain - Add 2 more skill blocks (provider tests, type checking) - Add 10 new tests Related: apache#62500
…k guidance - Scan both AGENTS.md and contributing-docs/*.rst as sources - Add skill block to 03_contributors_quick_start.rst - Update pre-commit hook trigger to cover RST files - Add 3 new tests (24 total, 8 skills) Related: apache#62500
- test_full_pipeline_rst_to_command: RST skill block -> extraction -> skills.json -> get_command() returning correct uv command - test_wrong_context_returns_guidance: host-only skill called from breeze context returns actionable guidance - 26 tests passing total Related: apache#62500
- Add /.containerenv detection for Podman in breeze_context.py - Add --force-context flag to override automatic detection - Make uv-first fallback chain explicit in run-single-test skill - Add run-static-checks-prek skill directly in 03_contributors_quick_start.rst - 9 skills total, 29 tests passing Related: apache#62500
boring-cyborg bot added area:dev-tools backport-to-v3-1-test 
1 task
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
1 participant
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.
PoC for #62500 — Airflow Contribution and Verification Agent Skills GSoC 2026
What is included
AGENTS.md and contributing-docs/03_contributors_quick_start.rst
contain agent-skill blocks embedded directly in contributor docs
(contributing-docs is the source of truth per Potiuk guidance)
extract_agent_skills.py scans both AGENTS.md and
contributing-docs/*.rst, validates against JSON schema,
generates skills.json. --check mode detects drift, exits 1 if stale.
breeze_context.py runtime API:
get_context() detects host vs Breeze vs Podman via 4-step
priority chain (AIRFLOW_BREEZE_CONTAINER env var ->
/.dockerenv -> /.containerenv -> /opt/airflow -> host).
get_command(skill_id, **kwargs) returns correct command
for current context. --force-context flag overrides detection.
skill_graph.py builds execution order tree from prereqs fields,
emits skill_graph.json, detects circular dependencies.
validate_skills.py standalone schema validator.
query_skills.py skill discovery CLI.
DX_REPORT.md documents concrete failure modes without vs
with Agent Skills.
3 pre-commit hooks wired in .pre-commit-config.yaml
9 skills total (7 in AGENTS.md, 2 in contributing-docs RST)
29 tests passing (unit + E2E + integration)
Design
Contributing-docs are the single source of truth per Potiuk's
guidance. Agent-skill blocks add machine-readable structure
inline. CI enforces sync via pre-commit hook.
uv-first with Breeze fallback only when system deps are missing.
Related: #62500