Skip to content

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

Merged
produtoramaxvision merged 2 commits into
mainfrom
docs/tool-design-inventory
May 31, 2026
Merged

docs(skills): add tool-design to inventory, reconcile counts to 101#64
produtoramaxvision merged 2 commits into
mainfrom
docs/tool-design-inventory

Conversation

@produtoramaxvision
Copy link
Copy Markdown
Owner

@produtoramaxvision produtoramaxvision commented May 30, 2026

Summary

Documentation follow-up to the tool-design skill (shipped in v0.1.2). Adds the skill to the inventory docs and reconciles the native skill count — previously inconsistent across files (100 / 72 / 76) — to the filesystem-verified total of 101.

No version bump (stays 0.1.2). Routed via /orchestratemaxvision-doc-writer.

Changes

File Change
docs/DOMAIN-SKILLS.md Doctrine 14→15, total 100→101, primary 72→73; new tool-design row (28 helpers unchanged)
docs/USER-GUIDE.md "All 100 skills" → 101; install-output "Skills: 100" → 101
docs/COMMANDS.md taxonomy "(100 skills)" → "(101 skills)"
docs/cheatsheets/CLAUDE-skills.md "total = 76" → 101 (76 was a stale undercount)
docs/cheatsheets/CLAUDE.md "100 skills nativas v0.1.0" → "101 skills nativas"

Verification

  • find skills -name SKILL.md -not -path "*/worktrees/*" | wc -l == 101
  • DOMAIN-SKILLS arithmetic: Doctrine 15 + Workflow 15 + User-facing 23 + Orchestration 20 = 73 primary; +28 helpers = 101 ✓

Out of scope (intentionally left)

  • README.md Skills table (orchestration-core only — tool-design doesn't fit)
  • .maxvision/ specs (historical/frozen)
  • COMMERCIAL.md "20–100 skills" (build-estimate range, not a count)

@codex @copilot @CodeRabbit — please review.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added the new "tool-design" skill, increasing total skills from 100 to 101.
  • Documentation

    • Updated guides, cheatsheets and examples to show Skills: 101 (including install snippet version bump).
    • Clarified cheatsheet breakdown: 73 primary (user-invocable) skills and 28 internal auxiliary skills.

Copilot AI review requested due to automatic review settings May 30, 2026 23:58
Add `tool-design` to the Doctrine layer in DOMAIN-SKILLS.md and reconcile
the native skill count across all docs to the filesystem-verified total of
101 (was inconsistently 100/72/76 across files).

- DOMAIN-SKILLS.md: Doctrine 14->15, total 100->101, primary 72->73; new
  tool-design row (28 helpers unchanged; 73+28=101).
- USER-GUIDE.md: "All 100 skills" -> 101; install-output "Skills: 100" -> 101.
- COMMANDS.md: taxonomy "(100 skills)" -> "(101 skills)".
- cheatsheets/CLAUDE-skills.md: "total = 76" -> 101 (76 was a stale undercount).
- cheatsheets/CLAUDE.md: "100 skills nativas v0.1.0" -> "101 skills nativas".

No version bump (stays 0.1.2). README Skills table left untouched
(orchestration-core only). .maxvision/ specs untouched (historical).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 30, 2026

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c5a57c31-a4ad-4bb3-9681-1ec0e529b01f

📥 Commits

Reviewing files that changed from the base of the PR and between c83d941 and f478141.

📒 Files selected for processing (2)
  • docs/USER-GUIDE.md
  • docs/cheatsheets/CLAUDE-skills.md
✅ Files skipped from review due to trivial changes (1)
  • docs/USER-GUIDE.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/cheatsheets/CLAUDE-skills.md

📝 Walkthrough

Walkthrough

Documentation updates consistent with adding a new tool-design doctrine skill. docs/DOMAIN-SKILLS.md gains the skill and updates layer/table totals; docs/USER-GUIDE.md, docs/COMMANDS.md, and cheatsheets update displayed skill counts from 100 to 101.

Changes

Skill Count Update to 101

Layer / File(s) Summary
Skill taxonomy and documentation updates
docs/DOMAIN-SKILLS.md, docs/COMMANDS.md, docs/USER-GUIDE.md, docs/cheatsheets/CLAUDE-skills.md, docs/cheatsheets/CLAUDE.md
The primary taxonomy document adds a new tool-design skill to the Doctrine layer and increments the total from 100 to 101 skills. The user guide, command reference, and cheatsheets update their displayed skill counts and example output to show 101.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Poem

🐰 I hopped through docs with pen in paw,
A new "tool-design" joins the law —
From one hundred to one-oh-one,
The cheatsheets sing, the counts are done,
Freshly updated, neat and fun.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: adding the tool-design skill to documentation and updating skill counts from 100 to 101 across multiple files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/tool-design-inventory

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c83d9413e0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/USER-GUIDE.md
```
Installed maxvision@maxvision (v0.1.0)
Skills: 100
Skills: 101
Copy link
Copy Markdown

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 👍 / 👎.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/cheatsheets/CLAUDE-skills.md`:
- Line 23: A frase "Skills nativas total = **101**. Todas invocáveis via
`/maxvision:<skill-name>`" está incorreta; altere esse trecho para indicar que
há 101 skills nativas, mas apenas as marcadas como "user-invocable" podem ser
chamadas diretamente via o padrão `/maxvision:<skill-name>` e que outras skills
internas são não-invocáveis pelo usuário (orchestrate as instala/usa on-demand);
update the line containing "Skills nativas total = **101**. Todas invocáveis via
`/maxvision:<skill-name>`" to explicitly state the distinction and how to
identify/invoke user-invocable skills.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: fe3c043a-63eb-4425-a5ad-a1b9819afd25

📥 Commits

Reviewing files that changed from the base of the PR and between c2219d8 and c83d941.

📒 Files selected for processing (5)
  • docs/COMMANDS.md
  • docs/DOMAIN-SKILLS.md
  • docs/USER-GUIDE.md
  • docs/cheatsheets/CLAUDE-skills.md
  • docs/cheatsheets/CLAUDE.md

Comment thread docs/cheatsheets/CLAUDE-skills.md Outdated
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

@produtoramaxvision
Copy link
Copy Markdown
Owner Author

Both findings addressed in the latest commit:

  • @coderabbitai (Major)CLAUDE-skills.md: fixed the "Todas invocáveis" claim. Now states 73 primary (user-invocable) + 28 internal orchestrate helpers (not invocable), consistent with the DOMAIN-SKILLS taxonomy.
  • @codex (P3)USER-GUIDE.md: install-example banner bumped v0.1.0 → v0.1.2 to match the 101-skill count.

Copilot errored out on review (twice on prior PRs) — proceeding per maintainer policy.

@chatgpt-codex-connector
Copy link
Copy Markdown

To use Codex here, create an environment for this repo.

- CLAUDE-skills.md (CodeRabbit Major): "Todas invocáveis" was false after
  reconciling to 101 — 28 of the 101 are internal orchestrate helpers, not
  user-invocable. Clarify: 73 primary invocable + 28 internal helpers.
- USER-GUIDE.md (Codex P3): install-example banner showed v0.1.0 alongside
  the 101-skill count; a 101-skill install is v0.1.2. Bump banner to v0.1.2.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 31, 2026

Tip

For best results, initiate chat on the files or code changes.

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# List CodeRabbitAI's review comments on PR `#64` to find the one to resolve
gh api repos/produtoramaxvision/maxvision/pulls/64/comments \
  --jq '.[] | select(.user.login == "coderabbitai") | {id: .id, body: .body[0:120]}'

Length of output: 476


🏁 Script executed:

#!/bin/bash
# Check issue-level comments on PR `#64`
gh api repos/produtoramaxvision/maxvision/issues/64/comments \
  --jq '.[] | select(.user.login == "coderabbitai") | {id: .id, body: .body[0:150]}'

Length of output: 441



@produtoramaxvision It looks like there are no open review comments from me remaining on this PR (they may have already been resolved in a prior iteration). Either way, both fixes are confirmed and the documentation is now internally consistent:

  • 73 primary skills (user-invocable) + 28 internal helpers = 101 total
  • Version banner aligned to v0.1.2

The PR looks good to merge. 🐇

@produtoramaxvision produtoramaxvision merged commit 53a8d7f into main May 31, 2026
16 checks passed
@produtoramaxvision produtoramaxvision deleted the docs/tool-design-inventory branch May 31, 2026 00:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants