Existing Repo

This is your onboarding checklist when you inherit someone else's codebase. It walks through detection scripts to figure out what you're dealing with (monorepo, full-stack, microservices), maps the directory structure, and identifies existing conventions before you touch anything. Then it audits what guardrails are already there (Husky, ESLint, pre-commit hooks, commitlint) and only adds what's missing. The philosophy is sound: understand before modifying, respect existing patterns, don't reorganize. Covers both JavaScript and Python stacks with actual bash commands you can run. High effort rating is accurate since proper repository analysis takes time, but you'll avoid breaking things by rushing in.

skills.sh installs: 182
GitHub stars: 685
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add alinaqi/claude-bootstrap --skill existing-repo --agent claude-code

Installs into .claude/skills of the current project.

Files

Existing Repository Skill

For working with existing codebases - analyze structure, respect conventions, and set up proper guardrails without breaking anything.

Sources: Husky | lint-staged | pre-commit | commitlint

Core Principle

Understand before modifying. Existing repos have conventions, patterns, and history. Your job is to work within them, not reorganize them.

Phase 1: Repository Analysis

ALWAYS run this analysis first when joining an existing repo.

1.1 Basic Detection

# Check git status
git remote -v 2>/dev/null
git branch -a 2>/dev/null
git log --oneline -5 2>/dev/null

# Check for existing configs
ls -la .* 2>/dev/null | head -20
ls *.json *.toml *.yaml *.yml 2>/dev/null

1.2 Tech Stack Detection

# JavaScript/TypeScript
ls package.json tsconfig.json 2>/dev/null

# Python
ls pyproject.toml setup.py requirements*.txt 2>/dev/null

SKILL.md on GitHub

Details

Repository: github.com/alinaqi/claude-bootstrap
First seen: Jun 3, 2026