One-click install
npx skills add https://github.com/breengles/poor-man-OS-setup --skill docs-init-breengles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-init
Source: https://github.com/breengles/poor-man-OS-setup/tree/main/.claude/skills/docs-init
Command: npx skills add https://github.com/breengles/poor-man-OS-setup --skill docs-init-breengles

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Poor or missing technical documentation makes onboarding slow, decisions hard to reproduce, and components difficult to understand or maintain.

Core Features & Use Cases

  • Scope-aware documentation generation: Produces docs for either a specific component/path or the entire project when no scope is provided.
  • Architecture-grade outputs: Creates reference-style files covering overview, file structure, architecture/design, interfaces/APIs, configuration, key design decisions, dependencies, testing, and relationships between components.
  • Discoverable documentation index: Generates docs/README.md as an index with links and a quick-start section to connect the system overview to component details.

Quick Start

Ask docs-init to generate documentation for a specific component by providing an argument like src/auth.

Frequently Asked Questions about docs-init

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

FAQPage Schema
How do I generate technical documentation for a specific codebase component?

To generate technical documentation for a specific codebase component, provide a scoped path like src/auth to produce reference-style files covering architecture, APIs, configuration, and testing. It outputs formatted docs/component.md files and a top-level docs/README.md index.

What is the best way to create an architecture overview and documentation index for a repository?

Creating an architecture overview and documentation index for a repository involves reading project materials to generate a docs/README.md index. This index links system overviews to component details with a quick-start section for seamless project onboarding.

Can I document an entire project's architecture and API interfaces without specifying a scope?

You can document an entire project's architecture and API interfaces without specifying a scope. The system automatically targets the whole codebase when no component path is provided, generating comprehensive reference materials for all modules.

Does the generated documentation include details on key design decisions and dependencies?

The generated documentation includes details on key design decisions and dependencies. It produces architecture-grade outputs covering file structure, interfaces, configuration, testing coverage, and relationships between components.

How are the generated documentation files formatted and structured?

Generated documentation files are formatted using Prettier with a deterministic doc-coverage structure. They are saved as docs/<component>.md files alongside a top-level docs/README.md index to ensure discoverable and consistently structured technical writing.