skills.rest
AgustinMadygraf
AgustinMadygrafCOMMUNITY
Explore all skills by this author →
GitHub

0b-project-bootstrap-repair

Create and normalize base directories and files for Python projects.

Updated Mar 22, 2026
Search Tags:#python#scaffolding#bootstrap#repair#gitignore#project-structure#init-files
One-click install
npx skills add https://github.com/AgustinMadygraf/skills --skill 0b-project-bootstrap-repair
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: 0b-project-bootstrap-repair
Source: https://github.com/AgustinMadygraf/skills/tree/main/0b-project-bootstrap-repair
Command: npx skills add https://github.com/AgustinMadygraf/skills --skill 0b-project-bootstrap-repair

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Repair bootstrap scaffolding by creating and normalizing the project's base structure and essential files.

Core Features & Use Cases

  • Create missing base directories (src/, docs/, tests/, etc.) and essential files (run.py, README.md, .env, .env.example).
  • Ensure init.py files exist across Python packages to enable proper imports and package structure.
  • Update .gitignore to include ephemeral directories (like .tmp/) and safeguard git hygiene, plus add .gitkeep in empty dirs when required.
  • Real-world use: kick off a new project with a clean bootstrap to accelerate onboarding and consistency.

Quick Start

Run the bootstrap repair on your repository root to create missing scaffolding.

Frequently Asked Questions about 0b-project-bootstrap-repair

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

FAQPage Schema
How do I fix missing project structure and bootstrap files in a Python project?▼

To fix missing project structure, you can run a bootstrap repair that creates essential directories like src/ and tests/, adds required files such as README.md and .env, and normalizes the overall project scaffolding.

How do I add __init__.py files to existing Python packages to fix import errors?▼

Adding __init__.py files is handled by scanning your project and initializing Python packages automatically, ensuring proper imports and package structure across all required directories.

What is the best way to update .gitignore to exclude ephemeral directories like .tmp?▼

The best way to update .gitignore is to append entries for ephemeral directories like .tmp/ during the bootstrap normalization process, which safeguards git hygiene and prevents temporary files from being tracked.

Can I normalize legacy Python project structures without breaking existing code?▼

Yes, you can normalize legacy Python projects by enforcing required directories and adding .gitkeep files to empty folders, ensuring base structure consistency without altering your existing source code logic.

Why does my Python project need .gitkeep files in empty directories?▼

Your Python project needs .gitkeep files in empty directories because git does not track empty folders, so adding them ensures the bootstrap structure remains intact when pushed to version control.

Related Skills

Explore More Software Engineering Skills→
miloswrathmiloswrath

speckit-git-initialize

Initialize a Git repository with an initial commit when none exists.

Community
Intermediate
infiquetrainfiquetra
8

sdk-scaffolding

Generate complete SDK project structures for .NET, Python, or TypeScript.

Official
Intermediate
rarestgrarestg
1

code-quality

Automate code quality tooling setup for Python and JavaScript/TypeScript projects.

Community
Advanced
AgustinMadygrafAgustinMadygraf

0a-project-bootstrap-audit

Audit new Python project bootstrap structure and write findings to docs/todo.md.

Community
Intermediate