repo-scaffold-skill

Automate repository scaffolding for Python projects with modern tooling.

1|1|Updated Nov 18, 2025
One-click install
npx skills add https://github.com/shiong-tan/repo-scaffold-skill --skill repo-scaffold-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-scaffold-skill
Source: https://github.com/shiong-tan/repo-scaffold-skill/tree/main
Command: npx skills add https://github.com/shiong-tan/repo-scaffold-skill --skill repo-scaffold-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation and maintenance of production-ready repositories with modern tooling, ensuring consistent structure, tooling, and documentation across projects.

Core Features & Use Cases

  • Complete scaffolding for Python libraries, APIs, CLI tools, data science projects, ontologies, and LinkML schemas.
  • Integrated tooling including uv, ruff, mypy, pytest, pre-commit, and GitHub Actions templates for CI/CD.
  • Documentation & migration support with Diátaxis-based templates and troubleshooting guides, plus migration guidance for legacy setups.

Quick Start

Initiate the skill by saying: "Set up new repo in this folder" to Claude Code. Then Claude will guide you through the steps:

  1. assess project type and requirements
  2. initialize repository structure
  3. configure tooling and CI/CD
  4. create documentation templates
  5. initialize a git repository
  6. optionally configure GitHub settings

Frequently Asked Questions about repo-scaffold-skill

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

FAQPage Schema
How do I scaffold a Python repository with modern tooling and CI/CD?

Scaffold a Python repository by initiating the skill to automatically generate project structure, configure uv, ruff, mypy, pytest, pre-commit, and set up GitHub Actions CI/CD templates along with mkdocs documentation.

What project types can I generate scaffolding for using this automation?

Generate scaffolding for Python libraries, APIs, CLI tools, data science projects, ontologies, and LinkML schemas, providing end-to-end setup from directory structure to CI/CD and documentation.

Do I need uv and ruff installed to set up a new repo with this workflow?

Yes, the repository scaffolding workflow requires uv, ruff, mypy, pytest, pre-commit, and mkdocs templates to configure the environment, tooling, and documentation correctly.

Can I configure GitHub settings automatically when creating a new Python project?

Yes, repository creation includes optional GitHub configuration, automating repository initialization, CI/CD pipeline setup via GitHub Actions, and remote settings after local scaffolding is complete.

What's the best way to generate Diátaxis-based documentation for a new Python package?

Generate Diátaxis-based documentation by using the integrated mkdocs templates during the scaffolding process, creating structured troubleshooting guides and documentation workflows automatically.

Can I migrate a legacy Python project to use modern tools like uv and pre-commit?

Yes, the skill provides migration guidance for legacy setups, helping transition existing repositories to use modern tooling including uv, ruff, mypy, pytest, and pre-commit configurations.