What problem does it solve?
dot-github prevents repositories from drifting into inconsistent, unsafe, or unintentionally disruptive .github configurations by standardizing structure and agentic documentation patterns.
Core Features & Use Cases
- Enforces agentic documentation conventions: Defines how to structure
.github/AGENTS.md, workflows, prompts, and instruction scopes so agents can reliably discover and follow repository-specific operating guidance.
- Improves workflow safety and governance: Recommends disabling workflows via moving them to
.github/workflows-disabled/ rather than deleting them, preserving history and reducing operational risk.
- Reduces common GitHub anti-patterns: Warns against creating
.github/README.md (which overrides the repository homepage) and against inventing CODEOWNERS entries.
Quick Start
Load the dot-github skill when creating or updating files under your repository’s .github/ directory to ensure AGENTS.md and workflow documentation follow the required organizational patterns.