gh-repo-setup

Align GitHub repositories with canonical release-loop rulesets and policy files.

Updated May 1, 2026
One-click install
npx skills add https://github.com/arthur-debert/release --skill gh-repo-setup-arthur-debert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-repo-setup
Source: https://github.com/arthur-debert/release/tree/main/skills/gh-repo-setup
Command: npx skills add https://github.com/arthur-debert/release --skill gh-repo-setup-arthur-debert

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill brings an existing GitHub repository back into alignment with the canonical arthur-debert/* + lex-fmt/* “release-loop” conventions, including main-branch protection rulesets and standardized policy/config files.

Core Features & Use Cases

  • Main branch ruleset onboarding: Applies required branch protection rules using a canonical ruleset template, and auto-detects the required status checks from the repo’s actual PR-triggering workflows.
  • Policy sweep with idempotent file syncing: Copies canonical policy and setup files into the target repo, reporting created, updated, or ok for unchanged files, with an option to overwrite conflicts.
  • Stack-aware template selection: Detects the repo’s stack (rust/electron/vsce-ext/nvim-plugin/tree-sitter/static-site/brew-tap/github-action) to choose the correct managed template set.

Quick Start

Run the gh-repo-setup skill against your target repository to apply ruleset protection and sync the canonical policy files so the repo matches the release-loop setup.

Frequently Asked Questions about gh-repo-setup

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

FAQPage Schema
How do I apply GitHub branch protection rulesets to an existing repository?

Apply GitHub branch protection rulesets to an existing repository by running an idempotent PUT-replace operation that enforces canonical main-branch protection rules. The process auto-detects required status checks from actual PR-triggering workflows to ensure valid security controls.

How do I sync canonical policy files across multiple GitHub repositories?

Sync canonical policy files across GitHub repositories using a content-diff-aware sweep that reports created, updated, ok, or conflict statuses. This idempotent syncing ensures standardized config files match the target setup without overwriting unintended changes.

Does GitHub branch protection onboarding auto-detect required workflow status checks?

Yes, GitHub branch protection onboarding auto-detects required status checks by analyzing the repository's actual PR-triggering workflows. It uses this detection to configure the canonical ruleset template accurately for the specific repository.

How do I fix GitHub repository drift from standard security controls during an audit?

Fix GitHub repository drift from standard security controls during an audit by reapplying the canonical setup. This performs an idempotent ruleset replacement and a policy file sweep to restore main-branch protection and standardized configurations.

Can I apply repo onboarding templates for different stacks like rust or electron?

Yes, you can apply repo onboarding templates for different stacks including rust, electron, vsce-ext, nvim-plugin, tree-sitter, static-site, brew-tap, and github-action. The setup detects the repository's stack to choose the correct managed template set.

What is the best way to overwrite policy file conflicts during a GitHub repo setup?

Overwrite policy file conflicts during a GitHub repo setup by enabling the overwrite conflicts option during the policy sweep. This forces the canonical policy and setup files to replace existing content, ensuring strict alignment with the release-loop conventions.