# Hs:docs

> Analyze codebase and manage project documentation. Use for doc initialization, updates, summaries, codebase analysis.

- Skill: `danielleit241/hs-docs` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add danielleit241/hs-docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/danielleit241/hs-docs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: danielleit241 (https://skillmd.com/u/danielleit241)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/danielleit241/hs-docs

---


# Documentation Management

Analyze codebase and manage project documentation through scouting, analysis, and structured doc generation.

**IMPORTANT:** Invoke the `hs:project-organization` skill to organize the outputs.

## Default (No Arguments)

If invoked without arguments, use `ask_user capability` to present available documentation operations:

| Operation   | Description                            |
| ----------- | -------------------------------------- |
| `init`      | Analyze codebase & create initial docs |
| `update`    | Analyze changes & update docs          |
| `summarize` | Quick codebase summary                 |

Present as options via `ask_user capability` with header "Documentation Operation", question "What would you like to do?".

## Subcommands

| Subcommand           | Reference                          | Purpose                                            |
| -------------------- | ---------------------------------- | -------------------------------------------------- |
| `/hs:docs init`      | `references/init-workflow.md`      | Analyze codebase and create initial documentation  |
| `/hs:docs update`    | `references/update-workflow.md`    | Analyze codebase and update existing documentation |
| `/hs:docs summarize` | `references/summarize-workflow.md` | Quick analysis and update of codebase summary      |

## Routing

Parse `$ARGUMENTS` first word:

- `init` → Load `references/init-workflow.md`
- `update` → Load `references/update-workflow.md`
- `summarize` → Load `references/summarize-workflow.md`
- empty/unclear → ask_user capability (do not auto-run `init`)

If another workflow needs to decide whether docs should be touched before
invoking docs operations, load `references/documentation-management.md`.

## Shared Context

Documentation lives in `./docs` directory:

```
./docs
├── project-overview-pdr.md
├── code-standards.md
├── codebase-summary.md
├── design-guidelines.md
├── deployment-guide.md
├── system-architecture.md
└── project-roadmap.md
```

Use `docs/` directory as the source of truth for documentation.

When authoring or refreshing diagrams in `system-architecture.md`, apply `/hs:tech-graph`'s SVG layout rules for component spacing, arrow routing, label placement, and z-index ordering. Pair with `/hs:preview --diagram` for visual self-review, or use `/hs:tech-graph` directly for publish-grade output.

**IMPORTANT**: **Do not** start implementing code.