init-github-repo

Installation
SKILL.md

Init GitHub Repo

Initializes a complete GitHub repository by detecting the project type and generating a JTBD-focused README, CI/CD pipeline, license, .gitignore, and SEO-optimized repo metadata.

Workflow

  1. Detect project type — read pyproject.toml, package.json, Cargo.toml, go.mod, or other markers to determine language, package name, license, and version. See CICD.md.
  2. Initialize git — if not already a repo, run git init, then ask the user for their preferred name/email and set it at repo level. See GITHUB.md.
  3. Create .gitignore — generate language-appropriate .gitignore. See CICD.md.
  4. Create LICENSE — detect license from project metadata or default to Apache-2.0. See GITHUB.md.
  5. Write README.md — JTBD-focused structure with badges, problem statement, quick start, and install. See README-TEMPLATE.md.
  6. Create CI/CD workflow — generate .github/workflows/ci.yml matched to the detected language. See CICD.md.
  7. Create GitHub repo and push — create remote with gh repo create, set description and topics, commit and push. See GITHUB.md.
  8. Update profile README — clone the user's profile repo (GH_USER/GH_USER) if not present, add the new repo to the correct section alphabetically, commit and push. See GITHUB.md.
  9. Verify — confirm gh repo view shows correct description and topics, profile README updated, badges render correctly. See GITHUB.md.

Self-review checklist

Before delivering, verify ALL:

Installs
1
GitHub Stars
5
First Seen
Oct 3, 2026