Skip to content

Add generate-mcp-app skill for MCP Apps widget generation#55

Merged
akshay-viz merged 9 commits intomicrosoft:mainfrom
mikepenaMS:feature/generate-mcp-app
Apr 17, 2026
Merged

Add generate-mcp-app skill for MCP Apps widget generation#55
akshay-viz merged 9 commits intomicrosoft:mainfrom
mikepenaMS:feature/generate-mcp-app

Conversation

@mikepenaMS
Copy link
Copy Markdown
Member

@mikepenaMS mikepenaMS commented Mar 20, 2026

Summary

  • Adds a new mcp-apps plugin with the generate-mcp-app-ui skill
  • Generates self-contained MCP App widgets (HTML) from tool output
  • Includes API reference, design guidelines, and a sample widget
  • Registers the plugin in marketplace.json

What's included

  • plugins/mcp-apps/skills/generate-mcp-app-ui/SKILL.md - Skill definition
  • plugins/mcp-apps/references/mcp-apps-reference.md - MCP Apps API, CDN patterns, data type safety
  • plugins/mcp-apps/references/design-guidelines.md - Visual design defaults and theme tokens
  • plugins/mcp-apps/samples/flight-status-widget.html - Sample widget (ext-apps + Fluent only)
  • plugins/mcp-apps/.claude-plugin/plugin.json - Plugin metadata
  • plugins/mcp-apps/README.md - Install and usage docs

Testing

Evaluated across 53 widget types (maps, charts, dashboards, cards, tables, timelines, and more). 53/53 pass all 13 assertion checks, 53/53 render with content in Playwright tests, 0 JS errors, 9.8/10 average UX score.

New plugin that generates self-contained MCP App widgets (HTML) from tool output. Includes skill template, API reference, design guidelines, and a sample widget.
@mikepenaMS mikepenaMS requested a review from a team as a code owner March 20, 2026 23:01
Copilot AI review requested due to automatic review settings March 20, 2026 23:01
Copy link
Copy Markdown
Contributor

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.

Pull request overview

Adds a new mcp-apps plugin that defines a /generate-mcp-app skill for generating self-contained MCP App widget HTML from MCP tool outputs, along with supporting references, guidelines, a sample widget, and marketplace registration.

Changes:

  • Introduces the generate-mcp-app skill with an HTML template and generation/refinement rules.
  • Adds MCP Apps technical reference + widget design guidelines + a sample widget HTML.
  • Registers the new plugin in .claude-plugin/marketplace.json and adds plugin metadata/README.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
plugins/mcp-apps/skills/generate-mcp-app/SKILL.md New skill definition and generation template for MCP App widgets.
plugins/mcp-apps/references/mcp-apps-reference.md New technical reference for MCP Apps API, theming, CDN/library patterns, and type-safety guidance.
plugins/mcp-apps/references/design-guidelines.md New visual/design guidelines for widgets (loading/data/error states, tokens, interactions).
plugins/mcp-apps/samples/flight-status-widget.html New sample widget implementation demonstrating theming and rendering.
plugins/mcp-apps/README.md New plugin README describing usage and structure.
plugins/mcp-apps/.claude-plugin/plugin.json New plugin metadata for Claude marketplace/plugin discovery.
.claude-plugin/marketplace.json Registers mcp-apps plugin in the marketplace list.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread plugins/mcp-apps/references/design-guidelines.md
Comment thread plugins/mcp-apps/references/design-guidelines.md
Comment thread plugins/mcp-apps/references/mcp-apps-reference.md
Comment thread plugins/mcp-apps/references/mcp-apps-reference.md
Comment thread plugins/mcp-apps/README.md Outdated
Comment thread plugins/mcp-apps/samples/flight-status-widget.html
Comment thread plugins/mcp-apps/samples/flight-status-widget.html
Comment thread plugins/mcp-apps/samples/flight-status-widget.html Outdated
@mikepenaMS mikepenaMS marked this pull request as draft March 20, 2026 23:28
Comment thread plugins/mcp-apps/references/mcp-apps-reference.md Outdated
Comment thread .claude-plugin/marketplace.json
Comment thread .claude-plugin/marketplace.json
Comment thread plugins/mcp-apps/references/design-guidelines.md
Comment thread plugins/mcp-apps/references/design-guidelines.md
Comment thread plugins/mcp-apps/references/design-guidelines.md
Comment thread plugins/mcp-apps/references/design-guidelines.md Outdated
Comment thread plugins/mcp-apps/references/mcp-apps-reference.md Outdated
Comment thread plugins/mcp-apps/skills/generate-mcp-app/SKILL.md Outdated
Comment thread plugins/mcp-apps/skills/generate-mcp-app/SKILL.md Outdated
Comment thread plugins/mcp-apps/skills/generate-mcp-app/SKILL.md Outdated
Comment thread plugins/mcp-apps/skills/generate-mcp-app/SKILL.md Outdated
Comment thread plugins/mcp-apps/README.md Outdated
Comment thread plugins/mcp-apps/README.md
Comment thread plugins/mcp-apps/README.md Outdated
Text on brand backgrounds must use colorNeutralForegroundOnBrand (white),
not colorNeutralForeground1 (dark). Prevents unreadable dark-on-blue text.
@mikepenaMS mikepenaMS marked this pull request as ready for review April 7, 2026 13:39
Copilot AI review requested due to automatic review settings April 7, 2026 13:39
Copy link
Copy Markdown
Contributor

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.

Pull request overview

Copilot reviewed 9 out of 10 changed files in this pull request and generated 7 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread plugins/mcp-apps/skills/generate-mcp-app-ui/SKILL.md
Comment thread plugins/mcp-apps/references/design-guidelines.md
Comment thread plugins/mcp-apps/samples/flight-status-widget.html
Comment thread plugins/mcp-apps/samples/weather-refresh-widget.html
Comment thread plugins/mcp-apps/README.md
Comment thread plugins/mcp-apps/skills/generate-mcp-app-ui/SKILL.md
Comment thread evals/mcp-apps/generate-mcp-app/eval-runbook.md Outdated
…idelines

Body padding changed from 16px to 24px per official Copilot UX
guidelines. Generalized CDN library references in mcp-apps-reference.md
and eval assertions. The UMD global collision pattern is preserved with
generic placeholder names. Eval results confirm no regression (9.92/10
avg, 53/53 pass all layers).
…on/License

Renamed skill from generate-mcp-app to generate-mcp-app-ui to avoid
confusion with create-mcp-app in the ext-apps repo. Added else branch
in ontoolresult template to call renderError when structuredContent is
missing (prevents infinite loading spinner). Added Installation and
License sections to README. Reordered examples in SKILL.md. Added
weather sample to eval runbook related files. Eval results: 9.75/10
avg (no regression from 9.77 baseline).
Copilot AI review requested due to automatic review settings April 17, 2026 01:14
Copy link
Copy Markdown
Contributor

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.

Pull request overview

Copilot reviewed 9 out of 10 changed files in this pull request and generated 5 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread plugins/mcp-apps/skills/generate-mcp-app-ui/SKILL.md
Comment thread plugins/mcp-apps/skills/generate-mcp-app-ui/SKILL.md
Comment thread plugins/mcp-apps/samples/weather-refresh-widget.html
Comment thread plugins/mcp-apps/samples/flight-status-widget.html
Comment thread plugins/mcp-apps/samples/weather-refresh-widget.html
@akshay-viz akshay-viz merged commit 89252ac into microsoft:main Apr 17, 2026
5 of 6 checks passed
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.

5 participants