github-branch-policy

Audit GitHub repository branch policy and workflow hygiene for misconfigurations and drift.

1|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/Oceanswave/i-know-kung-fu --skill github-branch-policy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-branch-policy
Source: https://github.com/Oceanswave/i-know-kung-fu/tree/main/skills/github-branch-policy
Command: npx skills add https://github.com/Oceanswave/i-know-kung-fu --skill github-branch-policy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GitHub repositories often suffer from misconfigured branch policies, inconsistent required checks, and stale or ghost workflows that block automation and slow down delivery. This guide provides a repeatable audit to identify and remediate such drift.

Core Features & Use Cases

  • Comprehensive audit of branch protection rules, required status checks, and auto-merge settings.
  • Detection of ghost workflows, stale branches, and improper workflow registrations across repositories.
  • Clear remediation steps and commands to restore policy integrity and automated merging.

Quick Start

Audit a target repository's branch policy and run a full integrity check.

Frequently Asked Questions about github-branch-policy

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

FAQPage Schema
How do I audit GitHub branch protection rules and required status checks?

To audit GitHub branch protection rules, verify default-branch enforcement and validate active rulesets via gh and API checks. This process identifies misconfigurations in required status checks and highlights remediation paths with concrete commands.

What is the best way to detect ghost workflows and stale branches in my repository?

Detecting ghost workflows and stale branches involves checking for improper workflow registrations across repositories. An audit identifies this drift and provides clear remediation steps to restore policy integrity and automated merging.

How do I check auto-merge settings and delete-on-merge behavior for GitHub repositories?

Checking auto-merge settings and delete-on-merge behavior requires verifying repo settings via gh and API checks. The audit ensures auto-merge reliability and highlights remediation paths with concrete commands to correct improper configurations.

Why does my GitHub workflow hygiene drift and block automated delivery?

Workflow hygiene drift blocks automated delivery due to inconsistent required checks, misconfigured branch policies, and ghost workflows. Auditing repo settings validates active rulesets and identifies misconfigurations to restore policy integrity.

Can I use the gh CLI to review GitHub repository rulesets and bypass behavior?

Yes, you can use the gh CLI to review repository rulesets and bypass behavior. The audit verifies repo settings via gh and API checks, validating active rulesets and ensuring default-branch enforcement to identify drift.

When do I need to run a full branch policy integrity check on a GitHub repository?

You need to run a full branch policy integrity check when automation is blocked by inconsistent required checks or stale branches. Auditing identifies misconfigurations, auto-merge reliability issues, and ghost workflow registrations across repositories.