Skip to content

docs(skills): add tool-design to inventory, reconcile counts to 101 #64

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
produtoramaxvision merged 2 commits into from
May 31, 2026
+11 −10
Merged

docs(skills): add tool-design to inventory, reconcile counts to 101 #64

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c83d941
docs(skills): add tool-design to inventory, reconcile counts to 101
produtoramaxvision May 30, 2026
f478141
docs: address review — fix invocability claim + install-example version
produtoramaxvision May 31, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/COMMANDS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
9 changes: 5 additions & 4 deletions docs/DOMAIN-SKILLS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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`,
Expand All @@ -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.
Expand All @@ -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)

Expand Down
6 changes: 3 additions & 3 deletions docs/USER-GUIDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot May 31, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P3 Badge Keep install example version in sync

This expected-output block now combines the v0.1.0 install banner with the 101-skill count, but tool-design is documented in CHANGELOG.md as added in 0.1.2 and the plugin metadata currently reports 0.1.2. Users validating a fresh install will never see this exact output: v0.1.0 had the old skill set, while a 101-skill install should be labeled v0.1.2.

Useful? React with 👍 / 👎.

Subagents: 34 (33 maxvision-* specialists + 1 orchestrator)
Commands: 40
Hooks: 8 events (SubagentStart, SessionEnd, SessionStart, PreToolUse, PostToolUse, ConfigChange, CwdChanged, InstructionsLoaded)
Expand Down Expand Up @@ -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) |
Expand Down
2 changes: 1 addition & 1 deletion docs/cheatsheets/CLAUDE-skills.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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/`**.

Expand Down
2 changes: 1 addition & 1 deletion docs/cheatsheets/CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
Loading