.github

Default metadata files across all repositories in the @UseAlloy organization.

Pull Request (PR) Template

All repositories should use the PR template located in the .github directory.

Create PRs via GitHub CLI

You can use the GitHub CLI to create PRs:

gh pr create --web

Tip

Make sure to have the gh CLI installed and up to date: brew install gh

The template will be automatically prefilled when opened in your browser.

Create PRs via AI Agents

Use your AI agent of choice by installing the agent skill with the GitHub CLI:

gh skill install UseAlloy/.github pr-create

Tip

Make sure to have the gh CLI installed and up to date: brew install gh

You can then ask an AI agent to create a PR, or call the skill directly in the prompt:

/pr-create

The skill drafts a PR summary from the branch's diff (title, overview, test instructions, risks) and offers to create a new PR or update an existing one.

Validate branch names

A skill is available to ensure git branch names conform to the Alloy organization standard.

gh skill install UseAlloy/.github branch-validate

It ships with a validate-branch.sh script to validate branch names.