CtrlK
BlogDocsLog inGet started
Tessl Logo

migrate-oai-app

This skill should be used when the user asks to "migrate from OpenAI Apps SDK", "convert OpenAI App to MCP", "port from window.openai", "migrate from skybridge", "convert openai/outputTemplate", or needs guidance on converting OpenAI Apps SDK applications to MCP Apps SDK. Provides step-by-step migration guidance with API mapping tables.

74

Quality

93%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

An excellent instructional body: every section is actionable, the workflow includes a pre-migration investigation phase, a finishing checklist, and runtime verification steps. The only nit is minor redundancy in repeated pointers to the same migration doc and a single background sentence.

DimensionReasoningScore

Conciseness

The body is dense with tables and commands and teaches nothing Claude already knows; minor trimmable fat remains (the pointer to migrate_from_openai_apps.md is repeated at three points, plus one background sentence about the SDK). It is above anchor 3 ('some unnecessary explanation') but short of anchor 5's 'every token earns its place'.

4 / 5

Actionability

Fully executable throughout: a version-resolving git clone command, a runnable two-terminal basic-host test procedure, exact search-pattern-to-replacement mapping tables, and concrete handler/method names. Copy-paste ready and covers the common migration cases.

5 / 5

Workflow Clarity

Clear sequence (clone reference repo -> numbered CSP investigation -> migrate -> 'Before Finishing' checkbox checklist -> test) with explicit validation checkpoints (confirm app loads, ontoolinput fires, ontoolresult fires) and error-recovery guidance (missing origins fail silently; add conditional origins).

5 / 5

Progressive Disclosure

No bundle files exist; the skill keeps SKILL.md as an overview and delegates all detail one level deep to the cloned repo, with per-file content tables for src/ and examples/ making navigation easy. References are clearly signaled and not nested.

5 / 5

Total

19

/

20

Passed

Description

90%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.

A strong description with explicit third-person what/when structure and excellent trigger phrase coverage. The only weakness is that the 'what' stays at the level of two generic deliverables rather than itemizing the concrete migration actions the skill performs.

Suggestions

Enumerate 3-4 concrete actions in the description (e.g., 'map window.openai globals to App event handlers, convert CSP and CORS configuration, register tools via registerAppTool()') so the 'what' is comprehensive rather than two generic deliverables.

Keep the change minimal: one clause of concrete actions is enough; avoid padding the description with the internal checklist or testing workflow.

DimensionReasoningScore

Specificity

"Provides step-by-step migration guidance with API mapping tables" names the domain plus two concrete actions, but does not enumerate the migration's coverage (server-side registration, client-side handler paradigm, CSP/CORS, testing), so it matches '1-2 concrete actions, not comprehensive' rather than anchor 4's 'several specific actions'.

3 / 5

Completeness

Explicitly answers both: what ("Provides step-by-step migration guidance with API mapping tables") and when ("This skill should be used when the user asks to..." with concrete trigger phrases), matching the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Five natural quoted trigger phrases ("migrate from OpenAI Apps SDK", "convert OpenAI App to MCP", "port from window.openai", "migrate from skybridge", "convert openai/outputTemplate") plus a generic restatement give comprehensive synonym coverage users would actually say.

5 / 5

Distinctiveness Conflict Risk

A clear niche (OpenAI Apps SDK to MCP Apps SDK) with distinct, unambiguous triggers; virtually no overlap risk with other skills.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
modelcontextprotocol/ext-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.