git-docs

SKILL.md preview

---
name: git-docs
description: >-
  Post-green doc accuracy: edit existing markdown in place only—no new/deleted/moved .md, no split/merge of files.
  Additive tweaks (bullets, links, facts) when the change set requires it; no-op if docs already match. After @git-review
  succeeds, or docs-only pass. Does not run write-quality-evaluate. New paths or doc-tree reshaping are normal edits outside this skill.
---

# `@git-docs` (documentation sync — no structure)

Normative fences / full matrix: [`read-repo-layout`](../../internal/read/repo/layout/SKILL.md), [`write-quality-documentation`](../../internal/write/quality/documentation/SKILL.md).

**Public.** **Goal:** After **`@git-review`** succeeds (or on a **docs-only** pass), update **existing** markdown so it matches the branch. **No-op** when docs already match. **Not** for failing tests—run **`@git-review`** first.

**Human onboarding** (install, git/gh flows): [`docs/onboarding.md`](../../../docs/onboarding.md).

## Language interaction policy

Always apply [`read-safety-language-interaction-rules`](../../internal/read/safety/language-interaction-rules/SKILL.md) first. Use English by default for all assistant output, including AskQuestion prompts/options, unless the user explicitly requests another full-language response.

## Before batch

**Always run first** (sequential). Complete every applicable row in this table before execution steps in this skill. Skip a row only when its **When** column does not apply.

| Kind | Skill / library | When |
| --- | --- | --- |
| **Recommended** | [`@git-review`](../review/SKILL.md) | Post-green pass after verify succeeded |
| **Tooling** | `git` | Repo root |




## Required internal skills

Run after **Before batch** completes (names only; normative fences in linked libraries).

| Library | Role |
| --- | --- |
| `read-repo-layout` | See linked library |
| `read-docs-wiki` | See linked library |
| `write-quality-documentation` | See linked library |
| `read-repo-classification` | See linked library |
| `read-docs-reference` | See linked library |
| `read-docs-user-guide` | See linked library |
| `read-docs-user-guide-user-guide-scaffold` | See linked library |
| `read-docs-explanation` | See linked library |
| `read-docs-index` | See linked library |
| `read-docs-table` | See linked library |
| `read-docs-exemplars` | See linked library |
| `read-docs-mirror-bootstrap` | See linked library |
| `read-docs-readme-root` | See linked library |
| `read-docs-readme-root-root-readme-scaffold` | See linked library |
| `read-docs-graphs` | See linked library |
| `read-docs-graphs-diagrams-diagrams-index` | See linked library |
| `read-docs-graphs-diagrams-examples` | See linked library |
| `read-docs-graphs-diagrams-scaffold-sequence` | See linked library |
| `read-docs-graphs-diagrams-scaffold-decision` | See linked library |
| `read-docs-graphs-diagrams-scaffold-flowchart` | See linked library |
| `read-docs-graphs-diagrams-scaffold-user-journey` | See linked library |
| `read-docs-graphs-diagrams-scaffold-stakeholder-flow` | See linked library |
| `read-docs-graphs-diagrams-scaffold-domain-taxonomy` | See linked library |
| `read-docs-graphs-diagrams-scaffold-state` | See linked library |
| `read-docs-graphs-diagrams-scaffold-dag` | See linked library |
| `read-docs-graphs-diagrams-palette` | See linked library |
| `read-docs-graphs-legacy-graphs-pack-scaffold` | See linked library |
| `read-docs-reference-docs-hub-scaffold` | See linked library |
| `read-docs-reference-reference-readme-scaffold` | See linked library |
| `read-docs-reference-wiki-reference-scaffold` | See linked library |

## Skip & suggestions

| Flag / param | Role |
| --- | --- |
| **`skip=false`** | Root invocation — offer next-step suggestions after **Verification** |
| **`skip=true`** | Nested public-skill child call — no next-step prompt |
| **`SKIP_QA_GIT_DOCS=true`** | Bypass routine write gates for this skill |
| **`SKIP_QA_WRITE=true`** | Shared write-flow Q&A bypas

…