Skip to content

POC: Agent Skills — YAML-driven workflow specs for AI coding agents#63876

Draft
Pyasma wants to merge 2 commits intoapache:mainfrom
Pyasma:feat/gsoc-agent-skills-yaml-workflows
Draft

POC: Agent Skills — YAML-driven workflow specs for AI coding agents#63876
Pyasma wants to merge 2 commits intoapache:mainfrom
Pyasma:feat/gsoc-agent-skills-yaml-workflows

Conversation

@Pyasma
Copy link
Contributor

@Pyasma Pyasma commented Mar 18, 2026

#62500

contributing-docs/workflows/*.yaml — one YAML spec per workflow skill, declaring steps, execution context, fallback logic, and expected output (5 initial skills)
generate_agent_skills.py — validates the YAMLs and generates skills.json (flat skill list) and skill_graph.json (dependency graph)
context_detect.py — detects host vs. Breeze at runtime and returns the correct command for a given skill
Full test coverage for both scripts

Out of scope

CI enforcement of YAML/JSON drift
Integration with CLAUDE.md or RST docs (scaffolded, not enforced)
Expanding beyond the 5 initial skills

  • Yes (please specify the tool below)

Claude 4.6

Pyasma added 2 commits March 17, 2026 19:28
Move repeated in-function `import ci.prek.context_detect as cd` to the
top of test_context_detect.py. Remove unused variable `sid` in
validate_workflow. Add missing YAML document start markers (---) to all
workflow YAML files. Apply ruff formatting across Python files.
Explicitly extract the skills_json kwarg from CLI params and convert it
to a Path before passing to get_command, so mypy can verify the Path
type rather than seeing an untyped **dict[str, str] expansion.
@boring-cyborg boring-cyborg bot added area:dev-tools backport-to-v3-1-test Mark PR with this label to backport to v3-1-test branch labels Mar 18, 2026
@Pyasma Pyasma marked this pull request as draft March 18, 2026 12:31
@Pyasma Pyasma changed the title Feat/gsoc agent skills yaml workflows POC: Agent Skills — YAML-driven workflow specs for AI coding agents Mar 18, 2026
@Pyasma
Copy link
Contributor Author

Pyasma commented Mar 18, 2026

This PR is in Working Stage Right now But i would still prefer Feedback

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:dev-tools 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.

1 participant