gh-bootstrap

Configure GitHub repositories for merge-queue, squash-only merging, and label-driven release notes.

1|Updated May 8, 2026
One-click install
npx skills add https://github.com/paulnsorensen/skillz-that-grillz --skill gh-bootstrap-paulnsorensen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-bootstrap
Source: https://github.com/paulnsorensen/skillz-that-grillz/tree/main/skills/gh-bootstrap
Command: npx skills add https://github.com/paulnsorensen/skillz-that-grillz --skill gh-bootstrap-paulnsorensen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Removes the repetitive, error-prone work of manually configuring GitHub repo policies for a secure merge workflow with squash-only merges and consistent, automated release notes.

Core Features & Use Cases

  • Merge defaults + squash-only policy: Enforces squash-only merges so the default branch history stays clean and PR titles/bodies map predictably into commit messages.
  • Ruleset-based branch protection: Installs a modern ruleset that blocks direct pushes/deletions and can enable merge queue behavior (when supported) with required reviews and required CI checks.
  • Auto-generated release notes setup: Scaffolds a .github/release.yml configuration and optionally a tag-triggered release workflow that generates release notes from merged PRs and their labels.
  • Idempotent reconfiguration: Safely re-runs to fill missing pieces without duplicating rulesets, and it prompts when overwriting existing release configuration artifacts would clobber user intent.

Quick Start

Run the /gh-bootstrap skill against a fresh or loosely-configured GitHub repository to configure merge queue (when available), squash-only merges, branch protection rulesets, and label-driven auto-generated release notes.

Frequently Asked Questions about gh-bootstrap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a GitHub merge queue with squash-only merges?

Setting up branch protection rulesets for merge queues involves creating a ruleset via the GitHub API that blocks direct pushes and deletions while requiring CI status checks. This Skill automates that ruleset creation idempotently without duplicating existing configurations.

How do I automate release notes generation from merged pull requests?

Automating release notes from merged pull requests requires scaffolding a .github/release.yml configuration file and optionally a tag-triggered workflow. This setup generates organized release notes based on PR labels applied during the merge process.

Can I safely re-run repository bootstrap settings without duplicating rulesets?

Yes, you can safely re-run repository bootstrap settings because the configuration process is idempotent. It fills in missing pieces without duplicating existing rulesets and prompts you before overwriting existing release configuration artifacts to prevent data loss.

Does GitHub branch protection via rulesets support required CI status checks?

GitHub branch protection rulesets fully support required CI status checks. The configuration matches required status check names exactly to your CI pipeline checks, ensuring merges are blocked until all required validations pass successfully.

What's the best way to enforce squash merge policies on a new GitHub repository?

The best way to enforce squash merge policies on a new GitHub repository is by applying a modern ruleset that restricts merge types to squash-only. This prevents direct pushes and maintains a clean, linear default branch history.

Why are my GitHub release notes not generating from PR labels correctly?

GitHub release notes may not generate correctly from PR labels if the .github/release.yml configuration is missing or misconfigured. Proper setup requires scaffolding the release configuration file to map specific labels to release note categories.