setup-new-repo

Bootstraps greenfield repositories with uv, pre-commit hooks, CI workflows, and GitHub remotes.

3|Updated Feb 15, 2025
One-click install
npx skills add https://github.com/mark-torres10/ai_tools --skill setup-new-repo-mark-torres10
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-new-repo
Source: https://github.com/mark-torres10/ai_tools/tree/main/skills/setup-new-repo
Command: npx skills add https://github.com/mark-torres10/ai_tools --skill setup-new-repo-mark-torres10

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new repository involves many repetitive, error-prone steps: configuring Python packaging, linting, type checking, CI pipelines, gitignore rules, and GitHub remotes. This Skill automates the entire bootstrap sequence so a new project starts with consistent, working tooling from day one. ## Core Features & Use Cases - Python Project Scaffolding: Initializes uv-based projects with pyproject.toml, ruff, pyright, complexipy, and pytest configured with standard settings. - Pre-commit and CI Setup: Writes .pre-commit-config.yaml and GitHub Actions workflows that mirror each other, covering lint, format, type check, complexity, and tests, plus eslint/oxlint for JS/TS frontends. - Skill and Tooling Installation: Copies global Cursor skills into the project and installs required skill packages via npx skills add. - Use Case: You have an empty directory for a new FastAPI side project. Invoke this Skill to get a fully configured repo with uv.lock, pre-commit hooks installed, CI passing, and a GitHub remote connected in one guided workflow. ## Quick Start Set up this folder as a new Python repository with my standard tooling and connect it to a GitHub repo.

Frequently Asked Questions about setup-new-repo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a new Python project with uv and pre-commit hooks?

Run uv init to create pyproject.toml, add a test dependency group with ruff, pyright, complexipy, pre-commit, and pytest, then run uv sync and uv run pre-commit install. This Skill automates that full sequence including CI configuration.

What tools should a Python CI pipeline include for linting and type checking?

A standard Python CI pipeline uses ruff for linting and formatting, pyright for type checking, complexipy for cognitive complexity, and pytest for tests. The GitHub Actions workflow should use astral-sh/setup-uv with caching on pyproject.toml and uv.lock.

Can I use this setup for a project with a JavaScript or TypeScript frontend?

Yes, the workflow detects JS/TS stacks via package.json or a ui directory and adds eslint and oxlint lint gates to both pre-commit hooks and CI. The gitignore also covers node_modules and build caches alongside Python entries.

When should I not use a repo scaffolding workflow?

Avoid full scaffolding on mature repos that already have uv, pre-commit, and CI configured; extend the existing setup instead. It is also unsuitable for pure planning sessions where no files will be written.

How do I connect a local repo to GitHub using the gh CLI?

Initialize git, then either run git remote add origin with an existing repo URL or use gh repo create to make a new repository with your chosen visibility. Confirm the result with gh repo view and git remote -v before pushing.