repokit

Configure GitHub repository metadata, labels, settings, and docs numbering through the gh CLI.

1|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/mimukit/skills --skill repokit-mimukit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repokit
Source: https://github.com/mimukit/skills/tree/main/skills/repokit
Command: npx skills add https://github.com/mimukit/skills --skill repokit-mimukit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a GitHub repository to match team conventions involves scattered manual work: writing an About description and topics, creating workflow labels, flipping repo settings, scaffolding baseline files, and keeping docs filenames sortable. This Skill consolidates all of that into four auditable, preview-before-apply modes driven through the gh CLI. ## Core Features & Use Cases - About mode: Infers a one-line description, topics, and homepage from the repo's README and manifest, then reconciles against existing metadata with per-field approval. - Labels mode: Provisions canonical lifecycle, priority, and automation label sets (including an ai-review trigger), reconciling drift and respecting existing label schemes. - Setup mode: Brings a new repo up to convention in one pass by applying house settings (merge-commit-only, delete-branch-on-merge), scaffolding LICENSE, README, .gitignore, and AGENTS.md, then running about and labels. - Docs mode: Renumbers docs/ artifacts with zero-padded serials in creation order using git history, repairing references after renames. - Use Case: After creating a fresh GitHub repo, ask the agent to set it up; it previews the settings diff, asks which license to use, writes the baseline files, and provisions the full label vocabulary without committing anything. ## Quick Start Ask the agent to set up this repository's metadata, labels, and baseline files using repokit.

Frequently Asked Questions about repokit

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

FAQPage Schema
How do I set up a new GitHub repo's settings and files with the gh CLI?

Use repokit's setup mode, which diffs repo settings against a canonical map (merge-commit-only, delete-branch-on-merge, secret scanning), scaffolds missing baseline files like LICENSE, README, .gitignore, and AGENTS.md, then runs the about and labels modes. Every change is previewed and approved before applying.

How do I generate a GitHub About description and topics automatically?

The about mode reads your README and project manifest (package.json, pyproject.toml, Cargo.toml, and similar) to infer a one-line description and a focused topic set. It shows current versus proposed values per field and applies only what you approve via gh repo edit.

Can I provision GitHub labels for an issue workflow without overwriting existing ones?

Yes. The labels mode checks for existing schemes in each namespace (lifecycle, priority, automation) before diffing, and offers to map onto your current labels instead of adding a parallel set. Labels outside the canonical sets are never deleted unless you explicitly ask.

Does repokit work on a repo without a GitHub remote?

Only the docs mode works locally, since it renames files using git history and never calls GitHub. The about, labels, and setup modes require an authenticated gh CLI and an existing GitHub remote; without shell access, the skill prints the exact gh commands for you to run.

Why does repokit refuse to commit the files it creates?

repokit deliberately leaves scaffold files unstaged and docs renames staged so a commit skill or the user controls grouping and commit messages. This separation keeps repository configuration auditable and avoids mixing setup changes into unrelated commits.

How do I renumber docs files so they sort by creation date?

The docs mode assigns a zero-padded serial prefix to each dated artifact under docs/, ordered by filename date, git add time, or filesystem mtime. It previews the renames per directory, uses git mv for recoverability, and repairs all in-repo references to old paths.