just-init

Generate and refresh __init__.py docstrings to reflect Python package structure.

1|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/fredericosantos/skills --skill just-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: just-init
Source: https://github.com/fredericosantos/skills/tree/main/skills/just-init
Command: npx skills add https://github.com/fredericosantos/skills --skill just-init

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Navigating and documenting Python packages can become messy as projects grow. This Skill uses the init.py docstrings as living indexes to describe the current package structure, helping teams read, reason about, and update organization without losing context.

Core Features & Use Cases

  • Treat init.py docstrings as the master map of a package, exposing public exports and structure.
  • Automatically refresh docstrings when files are added, removed, or reorganized to keep the map accurate.
  • Aid onboarding and codebase understanding by providing a consistent, readable guide to nested packages and modules.

Quick Start

Generate or refresh init.py docstrings across a Python package to reflect the current directory structure.

Frequently Asked Questions about just-init

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

FAQPage Schema
How do I document a Python package structure for codebase navigation?

Document a Python package structure by treating __init__.py docstrings as living indexes. This approach maintains a standardized, readable guide to nested modules that updates automatically when files are added or removed.

Can I automatically update Python package docstrings when files are reorganized?

Yes, you can automatically refresh Python package docstrings when files are added, removed, or reorganized. This keeps the package map accurate and enforces a docstring-driven navigation model without manual updates.

What is the best way to onboard developers to a multi-file Python codebase?

Onboard developers to a multi-file Python codebase by generating standardized __init__.py docstrings. This provides a consistent, hierarchical package description exposing public exports and structure for quick codebase understanding.

Does this Python package documentation method work for nested modules?

Yes, this Python package documentation method works for nested modules by providing a consistent, readable guide to nested packages. It treats each package's __init__.py as a master map reflecting its contents accurately.

Why should I use __init__.py docstrings for codebase navigation instead of external docs?

Use __init__.py docstrings for codebase navigation because they act as living indexes that stay synchronized with the actual directory structure. External docs often become outdated, whereas this model enforces real-time accuracy during codebase exploration.