CtrlK
BlogDocsLog inGet started
Tessl Logo

adobe/commerce-app-migration

Migrate an Adobe Commerce App Builder project from the Integration Starter Kit or Checkout Starter Kit to the new App Management approach. Run from the root of the App Builder project to be migrated. Pass --auto to skip confirmation prompts (suitable for CI or batch use).

66

Quality

83%

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

Overview
Quality
Evals
Security
Files

Quality

Content

73%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 content is highly actionable with a well-sequenced, validated migration workflow. Its main weakness is progressive disclosure: the body dispatches to many agent and shared reference files that are not actually present in the skill bundle, so the structured navigation is not realizable.

Suggestions

Ship the referenced bundle files (agents/analyzer.md, agents/executor.md, agents/events.md, agents/webhooks.md, agents/admin-ui-sdk.md, agents/business-config.md, and shared/schema.md, shared/questions.md, shared/migration-warnings.md, shared/references.md) or remove the dispatch references from the body so navigation matches the actual bundle.

Move the verbose metadata-derivation rules and full output-text blocks into a shared reference file to tighten the SKILL.md body and improve token efficiency.

Either reference references/spectrum-s2-upgrade.md where relevant or remove it from the bundle so the bundle contents align with what the body cites.

DimensionReasoningScore

Conciseness

The body is mostly efficient and avoids explaining known concepts, but it is lengthy with full output text blocks and verbose metadata-derivation rules that could be tightened and partly delegated to reference files.

3 / 5

Actionability

Fully executable guidance: exact agent dispatch paths, a complete app.commerce.config.ts template, exact flag behaviors, precise output strings, and concrete metadata derivation rules covering common cases.

5 / 5

Workflow Clarity

A clear 5-step sequence with explicit [await] checkpoints, preflight and alreadyMigrated early-exit validation gates, correction loops, and error relay for a destructive migration — feedback loops are present throughout.

5 / 5

Progressive Disclosure

The body references ten one-level-deep bundle files (agents/*.md, shared/*.md) as if they exist, but the actual bundle contains none of them (only references/spectrum-s2-upgrade.md, which the body never cites) — references point to missing files, breaking navigation.

2 / 5

Total

15

/

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.

The description is concrete, uses third-person voice, and provides an explicit 'Use when...' trigger clause tied to specific starter kits. It is a strong, complete description with only minor specificity and synonym-coverage gaps.

DimensionReasoningScore

Specificity

Names the domain and concrete actions (migrate the project, run from project root, --auto / --doc-scan-only flags with specific behaviors) with only minor gaps in coverage; not quite the exhaustive multi-action list of the 5 anchor.

4 / 5

Completeness

Clearly answers 'what' (migrate an Adobe Commerce App Builder project to App Management) and explicitly answers 'when' with a 'Use when...' clause and concrete trigger phrasing.

5 / 5

Trigger Term Quality

Natural trigger phrases like 'migrate an App Builder project from the Integration Starter Kit or Checkout Starter Kit' and 'mentions upgrading their Adobe Commerce extension architecture' are present, but coverage is jargon-heavy with few synonyms.

4 / 5

Distinctiveness Conflict Risk

A clear niche — Adobe Commerce App Builder migration from specific named starter kits — with distinct triggers and minimal overlap with other skills.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 10 missing

Warning

Total

15

/

16

Passed

Reviewed

Table of Contents