project-bootstrapping_skill

Overview

This skill bootstraps new projects or improves existing repositories by adding development best practices, tooling, documentation, and workflow automation. It focuses on practical, repeatable setups that speed onboarding and reduce technical debt. Deliverables include project structure, CI/CD, testing, linters, dependency management, and clear developer documentation.

How this skill works

The skill asks a few discovery questions about project type, language, collaboration model, and deployment targets. It analyzes an existing codebase (if provided), produces a tailored plan, then writes or edits configuration files, documentation, and scripts. Implementation is incremental: create structure, add git and CI configs, enable quality tooling, and verify with tests and handoff docs.

When to use it

• Starting a new project and wanting a professional template
• Improving structure, docs, or workflows in an existing repo
• Adding testing, linters, or type checking to a codebase
• Setting up CI/CD, release automation, or dependency updates
• Preparing a project for team collaboration or open-source contribution

Best practices

• Run a short discovery to scope full vs partial bootstrap before changes
• Prefer minimal, well-documented defaults that follow language conventions
• Add automated checks (pre-commit + CI) early to prevent regressions
• Include clear CONTRIBUTING, README, and environment templates for onboarding
• Use lockfiles and automated dependency updates to reduce supply-chain risk

Example use cases

• Bootstrap a Python CLI tool with packaging, tests, mypy, and GitHub Actions
• Improve an existing web app by adding testing, linting, Docker, and deployment workflow
• Add pre-commit hooks, .editorconfig, and a comprehensive .gitignore to a repo
• Create a reproducible dev environment with Makefile, .env.example, and start scripts
• Set up automated releases, changelog format, and status badges for an open-source library