github-repo-creator
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.
When & Why to Use This Skill
This Claude skill automates the creation and initial configuration of GitHub repositories using the GitHub CLI (gh). It streamlines the developer workflow by handling repository naming, visibility settings, README initialization, license selection, and the seamless pushing of existing local projects to GitHub, ensuring a professional and standardized project start.
Use Cases
- New Project Initialization: Quickly set up a new public or private repository with a pre-configured README and specific license (e.g., MIT, Apache) without leaving the chat interface.
- Local to Remote Migration: Instantly transform a local directory into a GitHub repository and push all existing code to a newly created remote origin using the --source flag.
- Standardized Repository Setup: Ensure all new projects follow organizational standards by automatically applying specific .gitignore templates and visibility rules during the creation process.
| 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