Agent skill

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.

View SKILL.md on GitHub Repository
Stars 37
Forks 4

Install this agent skill to your Project

npx add-skill https://github.com/regenrek/agent-skills/tree/main/skills/gh-repo-bootstrap

SKILL.md

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.

bash
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:

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

Private repo with description:

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

Create repo in an organization:

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

Add gitignore + license templates:

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

Skip README and customize initial commit message:

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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

regenrek/agent-skills

shadcn-vite-iconify-landing-page

Build, critique, and iterate high-converting marketing or product landing pages using React + Vite + TypeScript + Tailwind and shadcn/ui components, with all icons sourced from Iconify. Use when the user asks for a landing page, sales page, signup page, CRO improvements, above-the-fold vs below-the-fold structure, hero + CTA copy, section order, or wants production-ready shadcn + Vite code.

37 4
Explore
regenrek/agent-skills

security-leak-guardrails

Sets up secret-leak prevention guardrails with forbidden path checks, gitleaks config, CI secret scanning, and dependency updates. Use when hardening repos against credential leaks or when adding gitleaks, trufflehog, git hooks, or security checks.

37 4
Explore
regenrek/agent-skills

homebrew-publish

Publish CLIs/TUIs to Homebrew via a personal tap. Use when asked to create or manage a Homebrew tap repo, generate or update formulae, compute sha256, test installs, or ship new releases for Go, Rust, Node/TypeScript, Python, or prebuilt binaries.

37 4
Explore
regenrek/agent-skills

architecture-ownership

Determine runtime owner, first-fix layer, and canonical long-term module or package owner in layered codebases. Use when placing code across UI vs platform shell vs runtime orchestration vs domain or application vs shared core vs adapter or integration layers, debugging ownership issues, removing duplicate policy paths, or answering "where should this live?" architecture questions.

37 4
Explore
regenrek/agent-skills

codex-analysis

Run Codex CLI for deep code analysis and second-opinion reviews. Use when the user explicitly asks for Codex analysis, Codex help, or wants a second opinion from Codex on code, architecture, or debugging questions.

37 4
Explore
regenrek/agent-skills

go-local-health

Run local Go health checks (tests, coverage, lint) in Go repositories that contain go.mod/go.sum. Use when the user asks to run or interpret local Go test/coverage/lint workflows using tools like lazygotest, gocovsh, tparse, and golangci-lint. Do not use for Rust or non-Go projects.

37 4
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results