Skip to content

Update MCP reference for the use_skill tool - #5441

Open
Shannon Bradshaw (shannonbradshaw) wants to merge 1 commit into
mainfrom
claude/update-mcp-use-skill-tool
Open

Shannon Bradshaw (shannonbradshaw) wants to merge 1 commit into
mainfrom
claude/update-mcp-use-skill-tool

Conversation

@shannonbradshaw

Copy link
Copy Markdown
Collaborator

Source changes

  • APP-17973 — viamrobotics/app#14032 (d9911bb15): adds mcpserver/tools_skills.go, which registers use_skill with readOnlyTool(...). The tool returns a configuration playbook by name. The only playbook today is resource-notes, which explains the builder's notes scratchpad field and how to set it, including as a fragment overwrite. App deploys continuously, so the tool is live.

Documents: no ticket key found (APP-17973 and its parent APP-17885 have no DOCS ticket attached)

Docs changes

  • static/include/app/mcpserver/generated/mcp-tools-table.md: adds use_skill under Read-only. It reads built-in playbook text and changes nothing, so it matches the page's Read-only definition.

I checked every addTool call in mcpserver/ against the table. use_skill is the only missing tool apart from read_simulation, start_simulation and stop_simulation. Those three are left out on purpose: they work only for organizations with simulation enabled, and they're tracked for GA with the simulation UI.

How I found these

  • Xref lookup: none; the table is hand-maintained against mcpserver (see the docs repo's CLAUDE.md, "MCP server tool table").
  • Grep matches: use_skill, resource-notes, skill across docs/, static/, data/, layouts/, assets/: no existing mention.

make build-prod passes, and /reference/mcp/ renders the new row.


Generated by daily docs change agent


Generated by Claude Code

app#14032 (APP-17973) registers a read-only use_skill tool on the Viam MCP
server. It returns a configuration playbook by name; the first one,
resource-notes, explains the builder's notes scratchpad field.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HJj9jiAsPFAobPf781HS9K
@netlify

netlify Bot commented Oct 20, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for viam-docs ready!

Name Link
🔨 Latest commit 417d113
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/6ad73449905b73e18be89acb
😎 Deploy Preview https://deploy-preview-5441--viam-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 41 (🔴 down 1 from production)
Accessibility: 100 (no change from production)
Best Practices: 100 (no change from production)
SEO: 92 (no change from production)
PWA: 60 (no change from production)
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@viambot viambot added the safe to build This pull request is marked safe to build from a trusted zone label Oct 20, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

safe to build This pull request is marked safe to build from a trusted zone

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants