diff --git a/docs/COMMANDS.md b/docs/COMMANDS.md
index 692c2f2..216b724 100644
--- a/docs/COMMANDS.md
+++ b/docs/COMMANDS.md
@@ -108,7 +108,7 @@ field) for the full per-command flag list.
 ## Related references
 
 - [`docs/PHASE-MODEL.md`](PHASE-MODEL.md) — how Spec → Discuss → Plan → Execute → Verify → Ship connect.
-- [`docs/DOMAIN-SKILLS.md`](DOMAIN-SKILLS.md) — full skill taxonomy (100 skills).
+- [`docs/DOMAIN-SKILLS.md`](DOMAIN-SKILLS.md) — full skill taxonomy (101 skills).
 - [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) — orchestrate 8-phase flow + FTS5 routing.
 - [`commands/.maxvision-source.json`](../commands/.maxvision-source.json) — upstream provenance (`produtoramaxvision/maxvision@beb7e05`, MIT).
 - [`CHANGELOG.md`](../CHANGELOG.md) — release notes including `commands/` directory introduction.
diff --git a/docs/DOMAIN-SKILLS.md b/docs/DOMAIN-SKILLS.md
index ffc6162..32307af 100644
--- a/docs/DOMAIN-SKILLS.md
+++ b/docs/DOMAIN-SKILLS.md
@@ -1,6 +1,6 @@
 # Domain Skills — v0.1.0
 
-The plugin ships **100 skills** under [`skills/`](../skills/). The 72 primary
+The plugin ships **101 skills** under [`skills/`](../skills/). The 73 primary
 skills are organized into four functional layers and documented below.
 The remaining 28 are internal helpers, review variants, and platform skills
 (e.g. `analyze-candidates`, `keyword-extractor`, `query-index`, `grill-me`,
@@ -10,14 +10,14 @@ source is documented in [`LICENSES/THIRD-PARTY-NOTICES.md`](../LICENSES/THIRD-PA
 
 | Layer | Purpose | Count |
 | --- | --- | --- |
-| Doctrine | Cross-cutting craft rules (planning, TDD, debugging, review) | 14 |
+| Doctrine | Cross-cutting craft rules (planning, TDD, debugging, review) | 15 |
 | Workflow | Phase engine (spec → discuss → plan → execute → verify → ship) | 15 |
 | User-facing | Slash-command-style affordances for product flows | 23 |
 | Orchestration infra | Catalog, install/update, ephemeral lifecycle | 20 |
 | Internal helpers | Routing, scoring, sub-skills consumed by other skills | 28 |
-| **Total** | | **100** |
+| **Total** | | **101** |
 
-## Doctrine layer (14 skills)
+## Doctrine layer (15 skills)
 
 Cross-cutting craft rules — invoked by virtually every other skill via the
 `Skill()` tool.
@@ -38,6 +38,7 @@ Cross-cutting craft rules — invoked by virtually every other skill via the
 | [`writing-skills`](../skills/writing-skills/SKILL.md) | Author and verify new skills before deployment. |
 | [`subagent-driven-development`](../skills/subagent-driven-development/SKILL.md) | Execute plans with independent tasks via subagents. |
 | [`using-maxvision`](../skills/using-maxvision/SKILL.md) | Bootstrap skill — establishes how to find and invoke other skills. |
+| [`tool-design`](../skills/tool-design/SKILL.md) | Design the tools and MCP surfaces agents use effectively — tools-as-contracts, the consolidation principle, architectural reduction, description engineering, and MCP fully-qualified naming. Adapted from sickn33/antigravity-awesome-skills (CC BY 4.0). |
 
 ## Workflow layer (15 skills)
 
diff --git a/docs/USER-GUIDE.md b/docs/USER-GUIDE.md
index 12a6cd6..db0721e 100644
--- a/docs/USER-GUIDE.md
+++ b/docs/USER-GUIDE.md
@@ -18,8 +18,8 @@ For the quick demo of the lazy-load behavior, see
 Expected output:
 
 ```
-Installed maxvision@maxvision (v0.1.0)
-  Skills: 100
+Installed maxvision@maxvision (v0.1.2)
+  Skills: 101
   Subagents: 34 (33 maxvision-* specialists + 1 orchestrator)
   Commands: 40
   Hooks: 8 events (SubagentStart, SessionEnd, SessionStart, PreToolUse, PostToolUse, ConfigChange, CwdChanged, InstructionsLoaded)
@@ -253,7 +253,7 @@ Disable plugins you don't use. See
 | --- | --- |
 | Routing & FTS5 internals | [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) |
 | Phase lifecycle contract | [`docs/PHASE-MODEL.md`](PHASE-MODEL.md) |
-| All 100 skills | [`docs/DOMAIN-SKILLS.md`](DOMAIN-SKILLS.md) |
+| All 101 skills | [`docs/DOMAIN-SKILLS.md`](DOMAIN-SKILLS.md) |
 | All 40 slash commands | [`docs/COMMANDS.md`](COMMANDS.md) |
 | Hook strategy | [`docs/HOOKS-CROSS-PLATFORM.md`](HOOKS-CROSS-PLATFORM.md) |
 | Precedence rules | [`docs/INSTRUCTION-PRIORITY.md`](INSTRUCTION-PRIORITY.md) |
diff --git a/docs/cheatsheets/CLAUDE-skills.md b/docs/cheatsheets/CLAUDE-skills.md
index dc8e4d5..d2bb00c 100644
--- a/docs/cheatsheets/CLAUDE-skills.md
+++ b/docs/cheatsheets/CLAUDE-skills.md
@@ -20,7 +20,7 @@ Plugin v0.1.0 deixou de ser apenas orquestrador. Agora **absorve sob branding Ma
 | **R3** doctrine | produtoramaxvision/maxvision v5.1.0 | `brainstorming`, `writing-plans`, `executing-plans`, `subagent-driven-development`, `dispatching-parallel-agents`, `test-driven-development`, `systematic-debugging`, `verification-before-completion`, `requesting-code-review`, `receiving-code-review`, `finishing-a-development-branch`, `using-git-worktrees`, `writing-skills`, `using-maxvision` |
 | **R3** doctrine (adapted) | sickn33/antigravity-awesome-skills (CC BY 4.0) | `tool-design` |
 
-Skills nativas total = **76**. Todas invocáveis via `/maxvision:<skill-name>`. Skills externas (impeccable, frontend-design, anthropic-skills, etc.) continuam suportadas — orchestrate detecta e instala on-demand.
+Total de skills nativas = **101**. Destas, **73** são primárias (invocáveis via `/maxvision:<skill-name>`); as **28** restantes são helpers internos do fluxo orchestrate e não aparecem como comando user-invocable. Skills externas (impeccable, frontend-design, anthropic-skills, etc.) continuam suportadas — orchestrate detecta e instala on-demand.
 
 **Breaking change v0.6 → v1.0:** state directory `.planning/` → **`.maxvision/`**.
 
diff --git a/docs/cheatsheets/CLAUDE.md b/docs/cheatsheets/CLAUDE.md
index 78f99e9..8a8cd74 100644
--- a/docs/cheatsheets/CLAUDE.md
+++ b/docs/cheatsheets/CLAUDE.md
@@ -79,7 +79,7 @@ Skills R2 (phase engine: `discuss-phase`, `plan-phase`, `execute-phase`, `verify
 
 ## Skills (cheatsheet + orquestração)
 
-Cheatsheet de skills (frontmatter completo 14 fields, settings oficiais `skillListingBudgetFraction`/`maxSkillDescriptionChars`/`skillOverrides`, 100 skills nativas v0.1.0, bin tooling, padrões de uso, guardrails): @~/.claude/CLAUDE-skills.md
+Cheatsheet de skills (frontmatter completo 14 fields, settings oficiais `skillListingBudgetFraction`/`maxSkillDescriptionChars`/`skillOverrides`, 101 skills nativas, bin tooling, padrões de uso, guardrails): @~/.claude/CLAUDE-skills.md
 
 Para tarefas multi-domínio que precisam de subagent + skills coordenados (com checagem de versão upstream antes de usar), invocar `/maxvision:orchestrate <tarefa>` — flow de 10 fases (P-1 → P10) com hooks ativos em 8 events.