CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

micro-app-architect

Use for developing and maintaining a published SuperMagic HTML micro-app with the built-in micro-app.agent. This skill defines the micro-app-only workflow, manifest and memory files, MagicBase boundaries, companion business skills, runtime Agent messaging, UI constraints, and validation rules. Do not use it as the generic architecture guide for HTML apps opened from ordinary projects; use html-app-architect for that scenario.

Quality

90%

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

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

A high-quality contract-style skill body: it is dense and directive with exact file names, API signatures, tool names, and parameter shapes, and its workflow has explicit approval gates, validation loops, and an acceptance checklist. The only weaknesses are minor — a near-verbatim duplicated paragraph in Interaction Boundaries and a monolithic single-file layout that is at the upper bound of what belongs inline.

DimensionReasoningScore

Conciseness

The body is directive-dense with almost no explanation of concepts Claude already knows — every line is a domain-specific rule, file name, or API constraint. Minor trimmable redundancy exists: the trailing paragraph of 'Interaction Boundaries' restates the preceding bullets nearly verbatim ('For casual conversation, keep the response brief. Start the detailed workflow only for a concrete micro-app task...'), and the Acceptance Checklist re-summaries earlier sections. This fits anchor 4 (efficient with minor instances that could be trimmed) rather than anchor 5's every-token-earns-its-place, and is well above anchor 3's noticeable unnecessary explanation.

4 / 5

Actionability

Guidance is copy-paste concrete throughout: exact file names and manifest fields ('app.json', 'entry: "index.html"', 'metadata.form_draft: { "enabled": true, "storage": "sessionStorage" }'), exact tool calls ('read_skills(skill_names=[...], project_id=...)'), a complete executable createTopicAndSend code example, and precise error-handling rules ('Every catch and error callback must call console.error with operation context'). For an instruction-only skill this matches anchor 5 (fully executable, specific examples covering common cases); per the rubric's scoring note, absence of more code is not penalized when guidance is this actionable.

5 / 5

Workflow Clarity

The 10-step Development Workflow is clearly sequenced with explicit checkpoints: approval gate ('Do not write business files or change the schema before approval'), exact plan schema requirements (step 7), a memory-update step ('call update_html_app_memory once'), and a self-check step, capped by a full Acceptance Checklist. Destructive and batch operations have explicit validation loops ('Query and describe the scope of real data before deletion, then obtain explicit confirmation before using confirm_delete=true' and the logged-out login round-trip verification for form drafts), matching anchor 5's explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so everything is inline in one well-sectioned file with clear, navigable headers (Scope, AI Execution Routing, Development Workflow, Files and Manifest, Anonymous Access, MagicBase, Companion business skills, Agent Messages, UI, Acceptance Checklist). Structure is good and content is mostly appropriately placed, matching anchor 4; it falls short of anchor 5 only because ~125 lines of dense contract rules (e.g., the full form-draft lifecycle and MagicBase permission rules) are inlined where a leaner overview with reference files could split them, and short of anchor 3 because nothing is buried and sections are clearly signaled.

4 / 5

Total

18

/

20

Passed

Description

87%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: it opens with an explicit 'Use for...' trigger, enumerates a concrete scope, and closes with an explicit disambiguation against the sibling skill html-app-architect. The only softness is that the action verbs are generic ('developing and maintaining') and a few natural trigger variations are absent.

DimensionReasoningScore

Specificity

Enumerates concrete scope items ('manifest and memory files, MagicBase boundaries, companion business skills, runtime Agent messaging, UI constraints, and validation rules') with several specific deliverables, though the governing verbs ('developing and maintaining') stay generic. This fits anchor 4 (several specific items, minor coverage gaps) rather than 5, which would require multiple fully concrete actions; it is well above anchor 3, which covers only 1-2 concrete actions.

4 / 5

Completeness

Explicitly answers both questions: 'when' via the opening trigger clause 'Use for developing and maintaining a published SuperMagic HTML micro-app with the built-in micro-app.agent', and 'what' via the enumerated list of what the skill defines. It even adds a concrete negative trigger ('Do not use it as the generic architecture guide... use html-app-architect for that scenario'), matching anchor 5's clear and explicit what-and-when with concrete trigger phrases; anchor 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Contains strong natural domain terms a user in this environment would say: 'published SuperMagic HTML micro-app', 'micro-app.agent', 'MagicBase', 'manifest'. Good coverage but missing common variations or synonyms (e.g., 'create/build a micro-app', 'publish'), so anchor 4 fits better than the comprehensive synonym-and-extension coverage of anchor 5, and clearly above the sparse keyword coverage of anchor 3.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche ('published SuperMagic HTML micro-app', 'MagicBase', 'micro-app.agent') and explicitly disambiguates against the nearest competing skill ('use html-app-architect for that scenario'), giving minimal conflict risk. This matches anchor 5 (clear niche with distinct triggers); anchor 4 would imply residual overlap with closely related skills that the explicit boundary clause already resolves.

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

dtyq/magic

Path

backend/super-magic/agents/skills/micro-app-architect/SKILL.md

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.