Github repo setup

Skill 0GiS0/ghcp-agent-skills/personal-skills/github-repo-setup

🤖 Colección de Skills especializados para GitHub Copilot Agent que automatizan tareas comunes en desarrollo, documentación y configuración de repositorios

Install

npx -y skills add 0GiS0/ghcp-agent-skills --skill github-repo-setup

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
11 stars11 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Configure and initialize GitHub repositories with privacy settings, repository metadata, and feature toggles. Use when preparing repositories for publication on GitHub, including setting up private repositories, adding descriptions to repository about section, and disabling features like releases and environments.

SKILL.md

4.9 KB, as published. Nobody here has run it

GitHub Repository Setup

Prepare GitHub repositories for publication with proper configuration including privacy settings, metadata, and feature management using GitHub CLI.

⚠️ Note: This skill keeps repositories simple and minimal. It does NOT add LICENSE files, CODEOWNERS, CONTRIBUTING.md, SECURITY.md, or issue templates. It focuses only on core GitHub repository configuration.

Prerequisites

GitHub CLI (gh) installed and authenticated
Repository name defined
(Optional) Repository description for the about section

Checking GitHub CLI

Before using this skill, verify that GitHub CLI is installed and authenticated:

# Check if gh is installed
which gh

# If not installed, install it (macOS):
brew install gh

# For other systems:
# Windows: choco install gh
# Linux: Follow https://github.com/cli/cli/blob/trunk/docs/install_linux.md

# Authenticate with GitHub (if not already authenticated)
gh auth login

If gh is not installed, you'll see an error. Use the installation command for your operating system above.

Basic setup

Create and configure a new private GitHub repository (always private):

# Create a private repository
gh repo create <repo-name> --private --source=. --remote=origin --push

# Configure repository settings (add description)
gh repo edit <owner>/<repo-name> --description="Your repository description"

Complete setup workflow

Use this comprehensive workflow to set up a private repository with all recommended settings:

#!/bin/bash

# Variables
REPO_NAME="my-repository"
REPO_DESCRIPTION="Brief description of the repository"
OWNER="your-github-username"  # or your organization

# Step 0: Check if gh CLI is installed
if ! command -v gh &> /dev/null; then
    echo "GitHub CLI is not installed. Install it with:"
    echo "  macOS: brew install gh"
    echo "  Other systems: https://github.com/cli/cli#installation"
    exit 1
fi

# Step 1: Create private repository (always private)
gh repo create "${REPO_NAME}" \
  --private \
  --source=. \
  --remote=origin \
  --push \
  --description="${REPO_DESCRIPTION}"

# Step 2: Add description to about section (if needed)
gh repo edit "${OWNER}/${REPO_NAME}" --description="${REPO_DESCRIPTION}"

# Step 3: Disable wikis and discussions
gh repo edit "${OWNER}/${REPO_NAME}" --enable-wiki=false --enable-discussions=false

# Step 4: Open repository in browser
gh repo view "${OWNER}/${REPO_NAME}" --web

Configuration options

Repository type

Always private (default for this skill): All repositories created with this skill are automatically set to private for security and control.

If you need to change visibility later:

gh repo edit <owner>/<repo-name> --visibility private

Repository description

Set the description that appears in the repository's about section:

gh repo edit <owner>/<repo-name> --description "Your repository description"

The description should be concise and clearly communicate the repository's purpose.

Disable features

Disable releases: Releases are managed via branch protection rules and GitHub Actions workflows. To prevent accidental releases:

Use branch protection on main/master
Limit who can create releases via repository permissions

Disable environments:

# Environments are disabled by default for private repositories
# For public repositories, restrict environment access:
gh repo edit <owner>/<repo-name> --enable-discussions=false

Additional settings

Branch protection (protect main branch):

gh api repos/<owner>/<repo-name>/branches/main/protection \
  -X PUT \
  -F enforce_admins=true \
  -F require_code_review_count=1 \
  -F dismiss_stale_reviews=true

Disable wikis and discussions:

gh repo edit <owner>/<repo-name> --enable-wiki=false --enable-discussions=false

Add topics (optional):

gh repo edit <owner>/<repo-name> --add-topic python --add-topic github

Verifying configuration

Once setup is complete, your repository will open in the browser via gh repo view --web. You can also manually verify settings:

# View repository details
gh repo view <owner>/<repo-name>

# Check specific settings
gh api repos/<owner>/<repo-name> --jq '.{name, private, description, has_releases, has_environments}'

Tips

Test setup commands on a test repository first
Use environment variables for repetitive parameters
Automate setup with the provided script for consistency
Always verify settings after configuration
Use gh repo edit --help to see all available options