docs-first-run-enrichmentlisted

# docs-first-run-enrichment — Rich + Auto-Branded First Generation The problem this skill solves: a freshly-generated docs site produced by bare defaults looks like a skeleton — one or two thin pages, no visible brand, generic typography. This skill runs **before** the docs are published and wires two passes together so the first thing the user sees is a sellable site, not a stub. **Pass 1 — auto-brand from the source.** Extract real brand signals from whatever the user gave as source (URL, GitHub repo, description). Apply the derived branding to the workspace if one is connected; otherwise write the values into the docs config / theme files. No invented colors. **Pass 2 — enriched structure generation.** Decide on a multi-section outline derived from what the crawl found, then generate each section with the right content type (Diátaxis-aware), audience fit, style/tone, and navigation links wired between pages. --- ## When to use this skill Load it automatically during first-time docs generation: - The user gave a GitHub repo URL, a website URL, or a product description. - The docs have not been published yet for this workspace. - auto-mode is ON or the user chose this skill from the skill-selection question. Skip it (or skip Pass 1 only) when: - The workspace already has human-set branding — do not overwrite it. - A second or later generation run (enrichment is additive, not restorative). - The user explicitly said "skip branding" or "minimal / bare output". --- ##