Skip to content

feat: Breeze-aware AI agent skills system (GSoC 2026 PoC)#64012

Draft
Subham-KRLX wants to merge 1 commit intoapache:mainfrom
Subham-KRLX:poc/breeze-contribution-skills-poc
Draft

feat: Breeze-aware AI agent skills system (GSoC 2026 PoC)#64012
Subham-KRLX wants to merge 1 commit intoapache:mainfrom
Subham-KRLX:poc/breeze-contribution-skills-poc

Conversation

@Subham-KRLX
Copy link
Copy Markdown
Contributor

@Subham-KRLX Subham-KRLX commented Mar 20, 2026

PoC for #62500 — Airflow Contribution and Verification Agent Skills GSoC 2026.

Core Components

breeze_context.py — Environment detection (host vs Breeze) + context-aware commands + host-only guardrails
.agents/skills/ — 3 skills in agentskills.io standard (YAML frontmatter + Markdown body)

stage-changes (git add - host-only)
run-static-checks (prek run - both contexts)
run-unit-tests (uv run pytest / breeze exec pytest)

validate_skills.py — Pre-commit hook that enforces agentskills.io standard compliance

What Works
✅ 298/298 tests passing (unit + edge-case + end-to-end scenario exam)
✅ Zero lint/format errors
✅ Skills validated against agentskills.io spec
✅ Docker-only detection (aligned with docker_command_utils.py)
✅ No custom JSON artifacts — agentskills.io is the source of truth
Design Philosophy

YAML frontmatter + Markdown is natively consumed by Claude Code, Cursor, Gemini CLI
CI enforces standard compliance via pre-commit hook
Context-aware commands prevent agent failures in Breeze
Scenario exam proves real contributor workflows work

closes: #62500
Was generative AI tooling used to co-author this PR?

Yes — Gemini (Code Research and PR Description)

@boring-cyborg boring-cyborg bot added area:dev-tools area:UI Related to UI/UX. For Frontend Developers. backport-to-v3-1-test Mark PR with this label to backport to v3-1-test branch labels Mar 20, 2026
@Subham-KRLX Subham-KRLX marked this pull request as draft March 20, 2026 17:54
@Subham-KRLX Subham-KRLX force-pushed the poc/breeze-contribution-skills-poc branch from a2867e6 to f4611e1 Compare March 20, 2026 17:57
@Subham-KRLX Subham-KRLX force-pushed the poc/breeze-contribution-skills-poc branch 3 times, most recently from 8261fb9 to 1eb312d Compare March 26, 2026 01:07
@Subham-KRLX
Copy link
Copy Markdown
Contributor Author

Subham-KRLX commented Mar 26, 2026

quick update i found a compatibility issue between the airflow insert license hook and our validate agent skills standard hook the license hook adds an spdx comment to the top of skill md which was breaking the strict start of file check for yaml frontmatter in the latest commit i have updated the validation script to ignore leading html blocks this keeps both hooks happy and passes all 298 local tests if you'd prefer we just exclude these files from the license hook via pre commit config yaml to keep the validator logic simpler just let me know.

@Subham-KRLX Subham-KRLX force-pushed the poc/breeze-contribution-skills-poc branch from 43b66bd to 250038c Compare March 26, 2026 03:24
PoC for apache#62500 — Airflow Contribution and Verification Agent Skills.

- Implements BreezieContext for automated environment detection (Host vs. Breeze).
- Standardizes agent skills in the .agents/skills/ directory using agentskills.io format.
- Adds validate-agent-skills-standard pre-commit hook for automated compliance check.
- Includes rich documentation (AGENTS.md) and exhaustive test coverage for extraction logic.
@Subham-KRLX Subham-KRLX force-pushed the poc/breeze-contribution-skills-poc branch from 250038c to 67a96a1 Compare March 26, 2026 03:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:dev-tools area:UI Related to UI/UX. For Frontend Developers. backport-to-v3-1-test Mark PR with this label to backport to v3-1-test branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[GSOC 2026] Airflow Contribution & Verification Agent Skills

1 participant