sources.yml

# Master list of external skill sources federated into this repository.
#
# Each entry under `sources:` declares a repository that owns and versions a
# set of skills. The `import-external-skills` GitHub Actions workflow (nightly
# cron, plus manual dispatch) reads this file, shallow-clones each repo at the
# pinned `ref`, and vendors the named skill folders into `skills/<name>/`.
# Vendored skills are marked with a `.federated.json` file so the importer can
# manage them without disturbing skills authored directly in this repo.
#
# Schema:
#   sources:
#     - name:    short identifier for the source (kebab-case)
#       repo:    GitHub "<owner>/<repo>"
#       ref:     branch, tag, or full commit SHA (pinned for reproducibility)
#       path:    directory inside the repo that contains skill folders
#       license: SPDX license identifier (carried into the marker file)
#       skills:  list of skill folder names to import from `path`
#                Either a bare string (folder name) or a mapping:
#                  { name: <folder>, marketplace_description: <override> }
#
# To add or remove an imported skill, edit `skills:` here. The next nightly
# run (or a manual dispatch) validates the changes and pushes them straight
# to `main` (no pull request). A skill that fails validation is held back and
# reported as a `federated-import-failure` issue instead of blocking the
# others.

sources:
  - name: amd-agi-apex
    repo: AMD-AGI/Apex
    ref: main
    path: tools/skills
    license: MIT
    # `skill-creator` is intentionally excluded; this catalog already has
    # its own `create-skill` story via CONTRIBUTING.md.
    skills:
      - aiter-reflection
      - gpu-architecture-fundamentals
      - hip-kernel-optimization
      - kernel-exp-history
      - mi300-hip-programming-insights
      - pytorch-kernel-optimization
      - rocprof-compute
      - triton-hip-reference-kernel-search
      - triton-kernel-optimization
      - triton-kernel-reflection-prompts

  - name: amd-agi-magpie
    repo: AMD-AGI/Magpie
    ref: main
    path: skills
    license: MIT
    skills:
      - magpie