CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

migrate-app-to-flows

MUST be used when migrating a legacy Dune app to the new Flows app hosting infrastructure. Orchestrates the full migration: audits current state, updates app.json to appsApi infra, delegates auth wiring to setup-flows-auth, creates or updates manifest.json network permissions, and updates deploy scripts to @cognite/cli. Use this whenever a user says 'migrate to Flows', 'migrate to new infra', 'move from dune to flows', 'migrate legacy app', or wants to move their existing app to the new Flows app hosting.

Quality

95%

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.

A tight, highly actionable single-file skill: concrete commands and exact JSON shapes for every step, an audit-first and verify-last workflow with skip conditions, and zero padding. The only improvement is minor tightening of Step 2's slightly duplicated JSON examples.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no tutorials on CSP, JSON, or grep — with every step carrying domain-specific value. It is not 5 because Step 2 contains a mildly redundant pair of JSON examples (the 'After (correct)' deployments snippet followed immediately by another full app.json snippet showing the infra placement) that could be merged and trimmed.

4 / 5

Actionability

Fully executable throughout: copy-paste-ready grep commands ('grep -rn "fetch\|axios\|new XMLHttpRequest" src/ --include="*.ts" --include="*.tsx"'), exact JSON shapes for app.json and manifest.json, exact deploy script lines ('npx @cognite/cli@latest apps deploy --interactive'), and explicit delegation to setup-flows-auth. Covers the common cases including the empty-network edge case ('If no external calls exist, leave "network": []').

5 / 5

Workflow Clarity

Six clearly sequenced steps with an audit-before-change checkpoint (Step 1 report template), skip-if-already-done conditions ('If `infra` is already "appsApi", skip this step'), a verification pass (Step 6 grep for leftover Dune references), a completion checklist, and user-facing next steps. This matches the 5 anchor: explicit validation, feedback, and checklists are all present.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and none are needed — the entire skill fits appropriately inline as a single well-organized SKILL.md with clear section headers. The one cross-file dependency (the setup-flows-auth skill) is clearly signaled in its own step. Per the simple-skill guidance, well-organized sections with no need for external references score 5.

5 / 5

Total

19

/

20

Passed

Description

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

An excellent description: it states both what the skill does (a full five-part migration orchestration) and when to use it, using concrete quoted trigger phrases a user would naturally say. The only nitpick is the slightly imperious 'MUST be used' opener, but it costs almost nothing in clarity or token efficiency.

DimensionReasoningScore

Specificity

The description lists five concrete, verifiable actions ('audits current state, updates app.json to appsApi infra, delegates auth wiring to setup-flows-auth, creates or updates manifest.json network permissions, and updates deploy scripts to @cognite/cli'), giving comprehensive coverage of the migration. Not 4 because there are no coverage gaps — every phase of the migration is named.

5 / 5

Completeness

Both questions are answered explicitly: what ('Orchestrates the full migration: audits... updates... delegates... creates... updates...') and when ('Use this whenever a user says...') with concrete trigger phrases. Matches the 5 anchor exactly; not 4 because the 'when' clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

It quotes natural user phrasings directly: 'migrate to Flows', 'migrate to new infra', 'move from dune to flows', 'migrate legacy app', plus 'wants to move their existing app to the new Flows app hosting'. These cover the synonyms and informal variations a user would actually say; not 4 because no common natural phrasing is missing.

5 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche (legacy Dune app to Flows appsApi hosting) with named tools and files (app.json, manifest.json, @cognite/cli, setup-flows-auth), so it is unlikely to trigger for the wrong skill. Not 4 because there is no meaningful overlap with adjacent skills — the domain is highly specific.

5 / 5

Total

20

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

metadata_version

'metadata.version' is missing

Warning

Total

14

/

16

Passed

Repository

cognitedata/builder-skills

Path

skills/migrate-app-to-flows/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.