docs(skill): add UI support check and data handling gotchas #316
Conversation
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
@modelcontextprotocol/ext-apps
@modelcontextprotocol/server-basic-react
@modelcontextprotocol/server-basic-vanillajs
@modelcontextprotocol/server-budget-allocator
@modelcontextprotocol/server-cohort-heatmap
@modelcontextprotocol/server-customer-segmentation
@modelcontextprotocol/server-map
@modelcontextprotocol/server-pdf
@modelcontextprotocol/server-scenario-modeler
@modelcontextprotocol/server-shadertoy
@modelcontextprotocol/server-sheet-music
@modelcontextprotocol/server-system-monitor
@modelcontextprotocol/server-threejs
@modelcontextprotocol/server-transcript
@modelcontextprotocol/server-video-resource
@modelcontextprotocol/server-wiki-explorer
commit: |
antonpk1
force-pushed
the
docs/skill-gotchas
branch
2 times, most recently
from
f637900 to
1dbc6ae
Compare
antonpk1
force-pushed
the
docs/skill-gotchas
branch
from
1dbc6ae to
581cbf8
Compare
antonpk1
force-pushed
the
docs/skill-gotchas
branch
from
581cbf8 to
e2e8d7d
Compare
liady
approved these changes
Jan 21, 2026
jonathanhefner
approved these changes
Jan 21, 2026
Member
jonathanhefner
left a comment
jonathanhefner
left a comment
There was a problem hiding this comment.
I think some of this might be worth housing in TypeDoc examples + docs/patterns.md instead, but we can do that later.
Also, flagging that this depends on #313.
Otherwise, looks good. 👍
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.
Adds gotchas to the create-mcp-app skill:
Checking Host UI Support -
hasUiSupport()pattern for conditionally registering UI-enabled tools (assumes feat(server): add getUiCapability helper for capability negotiation #313 landed)Data Handling -
contentandstructuredContentgo to model context,_metadoes not. Don't put base64 instructuredContent.Describe UI in content - Always include text explaining what widget was rendered so model knows a UI was displayed.