Repository navigation
Update MCP reference for the use_skill tool - #5441
Open
Shannon Bradshaw (shannonbradshaw) wants to merge 1 commit into
Open
Shannon Bradshaw (shannonbradshaw) wants to merge 1 commit into
Shannon Bradshaw (shannonbradshaw) wants to merge 1 commit into
Conversation
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
✅ Deploy Preview for viam-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.

Source changes
mcpserver/tools_skills.go, which registersuse_skillwithreadOnlyTool(...). The tool returns a configuration playbook by name. The only playbook today isresource-notes, which explains the builder'snotesscratchpad 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: addsuse_skillunder Read-only. It reads built-in playbook text and changes nothing, so it matches the page's Read-only definition.I checked every
addToolcall inmcpserver/against the table.use_skillis the only missing tool apart fromread_simulation,start_simulationandstop_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
mcpserver(see the docs repo's CLAUDE.md, "MCP server tool table").use_skill,resource-notes,skillacrossdocs/,static/,data/,layouts/,assets/: no existing mention.make build-prodpasses, and/reference/mcp/renders the new row.Generated by daily docs change agent
Generated by Claude Code