python-package-skills

AI skills for Python package onboarding into Red Hat's AI package distribution pipeline (RHAI). These skills are consumed by the agentic-ci Claude runner image and orchestrated by the package-onboarding pipeline.

Portable guidance for coding agents lives in AGENTS.md and .agents/ at the repo root. That material is runtime-neutral. Claude Code additionally reads .claude/settings.json for sandbox and plugin settings; other agent runtimes should follow .agents/settings.json and .agents/runtime-guidance.md.

Skills

Skill	Description
constraint-bug-description	Describe a builder constraint and production-index version gap for Jira
executive-summary	Generate a 2-3 line executive summary of a packaging analysis
failure-analysis	Analyze a Python package build failure from log output
fondue-onboarding	Onboard a Python package into the fondue monorepo (builder/ and/or rhai-pipeline/)
hardware-variant	Resolve free-text hardware requirements to one allowed accelerator variant
jira-context-summary	Summarize Jira ticket context for downstream pipeline steps
license-check	Check license compatibility for redistribution
packaging-investigation	Deep investigation of a Python package for enterprise distribution
probe-test-onboarding	Create probe tests for a package in the wheels-test repository
security-audit	Run a security audit and produce a risk-rated report

Architecture

package-onboarding pipeline (orchestrator)
    |
    v
agentic-ci Claude runner (container)
    |
    v
python-package-skills (this repo, mounted as plugin)
    |
    +-- skills/constraint-bug-description/
    +-- skills/executive-summary/
    +-- skills/failure-analysis/
    +-- skills/fondue-onboarding/
    +-- skills/hardware-variant/
    +-- skills/jira-context-summary/
    +-- skills/license-check/
    +-- skills/packaging-investigation/
    +-- skills/probe-test-onboarding/
    +-- skills/security-audit/

The orchestrator prepares a workspace with context files and the target repository, then invokes a skill. The skill reads its context, operates on the repo, and produces git commits or output files.

Development

make lint          # Run skillsaw + ruff
make skillsaw      # Run skillsaw only
make skillsaw-fix  # Auto-fix skillsaw issues

License

Apache-2.0