file-manifest

File Manifest Reference

Use this skill for file-distribution manifests. Keep the main body small and open references only when the request needs them.

Core Rules

• File is parsed as a one-repo FileSet internally, but you still author the simpler shape
• Each file entry requires path and exactly one of content or source
• via defaults to push
• reconcile defaults to additive
• patches are applied after template expansion

File

apiVersion: gh-infra/v1
kind: File
metadata:
  owner: my-org
  name: my-repo
spec:
  files:
    - path: .github/CODEOWNERS
      content: |
        * @username
    - path: LICENSE
      source: ./templates/LICENSE
  via: push
  commit_message: "ci: sync managed files"

Key fields:

• files: required
• via: push or pull_request
• commit_message, branch, pr_title, pr_body: delivery controls. commit_message, pr_title, pr_body accept <% .Repo.Name %>, <% .Repo.FullName %>, <% .Source.URL %> (env GH_INFRA_SOURCE_URL, set in CI); see references/reconcile-and-delivery.md
• files[].vars: template variables
• files[].patches: unified diff patches
• files[].reconcile: additive, authoritative, create_only
• files[].executable: true for mode 100755, false for 100644, omitted keeps the current mode

Read these references as needed:

• Sources and templating: references/sources-and-templating.md
• Reconcile and delivery: references/reconcile-and-delivery.md
• Patches: references/patches.md
• FileSet and overrides: references/fileset.md
• Import-into behavior: use the dedicated import-into skill

FileSet

Use FileSet to distribute shared files to many repositories.

apiVersion: gh-infra/v1
kind: FileSet
metadata:
  owner: my-org
  name: shared-ci          # optional; names the FileSet, does not select repos

spec:
  repositories:
    - gomi                # simple string
    - enhancd
    - name: gh-infra      # struct with overrides
      overrides:
        - path: .github/CODEOWNERS
          content: |
            * @username @co-maintainer

  files:
    - path: .github/CODEOWNERS
      content: |
        * @username

    - path: LICENSE
      source: ./templates/LICENSE

  via: push