# 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.

- Skill: `majiayu000/github-repo-creator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/github-repo-creator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/github-repo-creator/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/github-repo-creator

---


# 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 status` to 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

```bash
# 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:
1. Confirm the repo was created successfully
2. Provide the repository URL to the user
3. Suggest next steps (add collaborators, set up CI/CD, etc.)

## Examples

**Create a new public repo and clone it:**
```bash
gh repo create my-awesome-project --public --description "A cool project" --clone
```

**Create repo from existing local project:**
```bash
gh repo create my-project --source=. --private --push
```

**Create with README and MIT license:**
```bash
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

