repo-settings-bootstrap

Create missing .github/settings.yml files for GitHub repository governance.

1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/droxey/skills --skill repo-settings-bootstrap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-settings-bootstrap
Source: https://github.com/droxey/skills/tree/main/repo-settings-bootstrap
Command: npx skills add https://github.com/droxey/skills --skill repo-settings-bootstrap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents repositories from missing critical settings-as-code governance by safely bootstrapping .github/settings.yml and related policy files with minimal, non-speculative changes.

Core Features & Use Cases

  • Settings-as-code scaffolding: Creates .github/settings.yml when missing, with conservative defaults aligned to repo evidence or an accompanying plan.
  • Companion governance when warranted: Optionally generates .github/CODEOWNERS and default-branch protection only when justified by context.
  • Inspection-first, minimal-risk policy: Supports both existing repo auditing and new repo creation scenarios while preserving explicit, authoritative settings and avoiding risky admin actions.

Quick Start

Use the repo-settings-bootstrap skill to bootstrap .github/settings.yml (and CODEOWNERS or branch protection only if clearly warranted) for a repository created from a project plan.

Frequently Asked Questions about repo-settings-bootstrap

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

FAQPage Schema
How do I bootstrap settings-as-code for a new GitHub repository?

To bootstrap settings-as-code, generate a .github/settings.yml file with conservative defaults aligned to repository evidence, optionally adding CODEOWNERS and branch protection rules only when clearly justified by your project context.

What is settings-as-code governance for GitHub repositories?

Settings-as-code governance manages repository policy by defining configuration in files like .github/settings.yml, enabling consistent security hygiene, branch protection enforcement, and code ownership tracking directly within the repository.

Can I add branch protection and CODEOWNERS without breaking existing repository policy?

Yes, you can safely add CODEOWNERS and branch protection by enforcing inspection-first behavior that preserves explicit existing choices, avoiding speculative required checks or unsafe administrative changes to current settings.

Does repo-settings-bootstrap work for auditing existing repositories?

Yes, repo-settings-bootstrap supports existing repository auditing by inspecting current settings-as-code artifacts and conditionally generating missing .github/settings.yml or CODEOWNERS files while preserving authoritative configurations.

What is the safest way to initialize GitHub repository policy files?

The safest way to initialize repository policy is through an inspection-first approach that creates minimal, non-speculative .github/settings.yml configurations, avoiding risky admin changes and preserving explicit existing settings.

When should I avoid generating speculative required checks in settings.yml?

You should avoid speculative required checks when bootstrapping settings.yml because the inspection-first policy preserves existing choices and only conditionally adds branch protection justified by actual repository evidence.