CtrlK
BlogDocsLog inGet started
Tessl Logo

mcp-apps-builder

**MANDATORY for ALL MCP server work** - mcp-use framework best practices and patterns. **READ THIS FIRST** before any MCP server work, including: - Creating new MCP servers - Modifying existing MCP servers (adding/updating tools, resources, prompts, widgets) - Debugging MCP server issues or errors - Reviewing MCP server code for quality, security, or performance - Answering questions about MCP development or mcp-use patterns - Making ANY changes to server.tool(), server.resource(), server.prompt(), or widgets This skill contains critical architecture decisions, security patterns, and common pitfalls. Always consult the relevant reference files BEFORE implementing MCP features.

64

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./generative_ui_agents/ai-mcp-app-builder/apps/mcp-use-server/.agent/skills/mcp-apps-builder/SKILL.md

The canonical home for this skill is mcp-apps-builder in CopilotKit/CopilotKit

SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The SKILL.md body is a model progressive-disclosure hub: it routes by task to real, one-level-deep reference files and backs its guidance with executable commands, code, and anti-pattern/fix pairs. Its only real cost is mild redundancy — the reference index is effectively presented twice and the opening directive section echoes the frontmatter.

DimensionReasoningScore

Conciseness

The body is dense and almost entirely non-obvious content — detection heuristics, scaffold commands, anti-pattern/fix pairs, golden rules, executable code — with no explanation of concepts Claude already knows. Minor trimmable redundancy keeps it below the lean level-5 anchor: the reference index appears twice ("Quick Navigation" with When/Covers bullets, then again as the "Decision Tree" covering the same files), and the opening "IMPORTANT: How to Use This Skill" section restates the frontmatter's directive. It is clearly above 'mostly efficient with some unnecessary explanation' at 3.

4 / 5

Actionability

Guidance is fully executable throughout: exact commands ("npx create-mcp-use-app my-server", "npm run dev"), a concrete project-detection check (package.json listing "mcp-use" or imports from "mcp-use/server"), a copy-paste-ready minimal server with working server.tool() registration, a complete 4-step typed widget-metadata pattern, and a response-helpers table with inline examples for every common case.

5 / 5

Workflow Clarity

The entry workflow is clearly sequenced with explicit branching: detect whether an mcp-use project exists, scaffold (greenfield) versus skip to navigation (existing), then route by feature to the right reference file — the detection step acts as a checkpoint against wrongly scaffolding into an existing project. It stays below level 5 because there is no result-validation step (e.g. verify the server/tool in the inspector after implementing), which the level-4 anchor's 'minor validation gaps' describes.

4 / 5

Progressive Disclosure

The body is exactly the overview the rubric wants: a navigation guide with well-signaled, one-level-deep references (all 18 referenced files under references/ exist), each entry carrying 'When' and 'Covers' lines, plus a decision tree for routing. Detailed material is appropriately deferred to those files and the body self-describes as containing only minimal examples.

5 / 5

Total

18

/

20

Passed

Description

70%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description has excellent explicit trigger guidance and good natural keywords tied tightly to the mcp-use niche, but its statement of what the skill actually does is padded and abstract ("best practices and patterns", "MANDATORY", "READ THIS FIRST") instead of naming concrete capabilities. Reframing it as concrete third-person capabilities plus the existing trigger list would lift it to top level.

Suggestions

Replace the abstract "best practices and patterns" framing with concrete third-person capabilities, e.g. "Builds and modifies MCP servers with the mcp-use framework: scaffolding projects, defining tools, resources, prompts, and React widgets, adding OAuth authentication, and deploying".

Spell out "Model Context Protocol (MCP)" once so users who say the full name trigger the skill naturally.

Trim directive padding ("MANDATORY", "READ THIS FIRST", "This skill contains critical...") — it adds tokens without adding trigger or capability information.

DimensionReasoningScore

Specificity

The description names the domain ("mcp-use framework best practices and patterns") and lists concrete work contexts ("Creating new MCP servers", "Modifying existing MCP servers (adding/updating tools, resources, prompts, widgets)", "Debugging MCP server issues"), but the core 'what' remains generic — it never states concrete capabilities like scaffolding, defining tools/resources/prompts, or building widgets. It matches 'names domain and some concrete actions, but not comprehensive' better than the level-4 anchor, which expects several specific listed actions describing what the skill does.

3 / 5

Completeness

The 'when' is explicit and strong ("READ THIS FIRST before any MCP server work, including:" followed by six concrete trigger contexts), satisfying the explicit-trigger-guidance requirement. The 'what' is present ("best practices and patterns", "critical architecture decisions, security patterns, and common pitfalls") but stays abstract rather than concretely naming the capability set, so it fits 'both what and when, but when/what could be more explicit' rather than the fully concrete level-5 anchor.

4 / 5

Trigger Term Quality

Good natural keyword coverage: "MCP server", "mcp-use", "tools, resources, prompts, widgets", "server.tool(), server.resource(), server.prompt()", "debugging", "security, or performance". A few natural terms are missing — notably the spelled-out "Model Context Protocol" and common phrasings like "add a tool to my MCP server" as bare keywords — so it falls just short of the comprehensive-synonyms anchor at 5 but clearly above 'some relevant keywords with missing variations' at 3.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (mcp-use framework) with distinct triggers ("mcp-use", "server.tool()", "widgets"), so it is mostly distinct. Minor overlap risk remains because "MANDATORY for ALL MCP server work" would also grab generic MCP server work not using the mcp-use framework, which keeps it below the minimal-conflict anchor at 5 but well above the broad-overlap anchors at 2-3.

4 / 5

Total

15

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 19 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 19 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository
Shubhamsaboo/awesome-llm-apps
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.