| name | github-repo-creator |
| description | Creates GitHub repositories with proper setup. Use when the user wants to create a new GitHub repo, initialize a repository, or set up a new project on GitHub. |
| allowed-tools | Bash, Read, Write, AskUserQuestion |
GitHub Repository Creator
Creates new GitHub repositories with professional setup using the gh CLI.
Prerequisites
- GitHub CLI (
gh) must be installed and authenticated - Run
gh auth statusto verify authentication
Instructions
When creating a GitHub repository:
1. Gather Information
Ask the user for:
- Repository name (required)
- Description (optional but recommended)
- Visibility: public or private (default: private)
- Initialize with: README, .gitignore, license
2. Create the Repository
# For a new repo (not from existing folder)
gh repo create <repo-name> --public/--private --description "description" --clone
# For existing local project
gh repo create <repo-name> --source=. --public/--private --push
3. Common Options
| Flag | Description |
|---|---|
--public |
Make repository public |
--private |
Make repository private |
--description "text" |
Add description |
--clone |
Clone the new repo locally |
--source=. |
Use current directory as source |
--push |
Push local commits to new repo |
--gitignore <template> |
Add .gitignore (e.g., Node, Python) |
--license <license> |
Add license (e.g., MIT, Apache-2.0) |
4. Post-Creation Setup
After creating the repo:
- Confirm the repo was created successfully
- Provide the repository URL to the user
- Suggest next steps (add collaborators, set up CI/CD, etc.)
Examples
Create a new public repo and clone it:
gh repo create my-awesome-project --public --description "A cool project" --clone
Create repo from existing local project:
gh repo create my-project --source=. --private --push
Create with README and MIT license:
gh repo create my-project --public --add-readme --license MIT
Future Enhancements
- Auto-generate repository banner/social image
- Template selection for common project types
- Automatic branch protection rules setup