gh-repo-bootstrap

Create a new GitHub repository with the gh CLI and bootstrap a local project in ~/projects with git init, README, remote setup, and initial push. Use when the user asks to create a repo (public/private) in their account, set up the local folder, add the upstream remote, and push the first commit.

⭐2stars🔀1forks📁View on GitHub🕐Updated Dec 31, 2025⬇️1downloads

When & Why to Use This Skill

The gh-repo-bootstrap skill automates the end-to-end process of creating and initializing GitHub repositories. By leveraging the GitHub CLI (gh), it streamlines the developer workflow by handling repository creation, local directory setup, git initialization, and the first push in a single command. This tool ensures consistent project structures and significantly reduces the time spent on repetitive manual configuration tasks.

Use Cases

  • Rapidly bootstrapping new software projects with standardized local and remote configurations to start coding immediately.
  • Creating private repositories for internal tools or experimental prototypes with automated initial commits and README generation.
  • Setting up organization-owned repositories with pre-configured licenses, gitignore templates, and descriptions via CLI automation.
  • Scaffolding multiple microservices or components efficiently while maintaining a consistent directory structure and naming convention.
namegh-repo-bootstrap
descriptionCreate a new GitHub repository with the gh CLI and bootstrap a local project in ~/projects with git init, README, remote setup, and initial push. Use when the user asks to create a repo (public/private) in their account, set up the local folder, add the upstream remote, and push the first commit.

GH Repo Bootstrap

Overview

Create a GitHub repo in the authenticated account and initialize a matching local project under ~/projects/<name> with a git repo, initial commit, remote, and upstream push using the bundled script.

Workflow

1) Collect inputs

  • Require: repo name, visibility (public or private).
  • Optional: description, owner/org (if not default account), gitignore template, license key, remote name, projects directory, README toggle, initial commit message.

2) Verify prerequisites

  • Confirm gh is installed and authenticated (gh auth status).
  • Confirm git is installed and user.name + user.email are configured.
  • Confirm ~/projects exists or can be created.

3) Run the script

Use the bundled script to create the local repo, commit, create the remote, and push.

python3 scripts/gh_repo_bootstrap.py <name> --visibility public|private [options]

4) Report results

Return the local path, remote URL, and current branch.

Examples

Minimal public repo:

python3 scripts/gh_repo_bootstrap.py my-app --visibility public

Private repo with description:

python3 scripts/gh_repo_bootstrap.py my-app --visibility private --description "My new project"

Create repo in an organization:

python3 scripts/gh_repo_bootstrap.py my-app --visibility public --owner my-org

Add gitignore + license templates:

python3 scripts/gh_repo_bootstrap.py my-app --visibility public --gitignore Go --license mit

Skip README and customize initial commit message:

python3 scripts/gh_repo_bootstrap.py my-app --visibility public --no-readme --commit-message "Initial scaffold"

Notes

  • Fail safely if the target directory exists and is not empty, or if the GitHub repo already exists.
  • Create README.md by default; use --no-readme to skip it.
  • Fetch gitignore and license templates via gh api only when requested.
  • Use --projects-dir to override the default ~/projects root.

Scripts

  • scripts/gh_repo_bootstrap.py: canonical automation for local setup, remote creation, and initial push.