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.
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.
| name | gh-repo-bootstrap |
|---|---|
| description | 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. |
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 (
publicorprivate). - 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
ghis installed and authenticated (gh auth status). - Confirm
gitis installed anduser.name+user.emailare configured. - Confirm
~/projectsexists 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.mdby default; use--no-readmeto skip it. - Fetch gitignore and license templates via
gh apionly when requested. - Use
--projects-dirto override the default~/projectsroot.
Scripts
scripts/gh_repo_bootstrap.py: canonical automation for local setup, remote creation, and initial push.