CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

start-flows-app

MUST be used when starting a new Flows custom app, especially after Fusion Custom apps Start building (prompt ends with ---Start Building---) or `npx @cognite/cli@latest apps skills pull`. Owns what the short Fusion prompt leaves out: local HTTPS (apps setup-https), GET token/inspect and appHostingAcl WRITE, the models/datamodels fallback, SME story, App-Brief after the conversation, deploy, sign as builder, and submit. Hands Industrial MCP connection to connect-atlas-mcp. Use whenever the user mentions token/inspect, appHostingAcl, mkcert, apps setup-https, SME story, or a clickable https://localhost prototype.

Quality

92%

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, well-sequenced operational skill: every section instructs rather than explains, failure modes have explicit handling branches, and details are properly delegated to linked sibling skills. The only minor gap is a couple of unstated inputs (bearer token source, serve command) inherited from the Fusion prompt.

DimensionReasoningScore

Conciseness

The body is lean, imperative, and assumes competence — no conceptual filler, each of the 7 sections delivers dense operational guidance ('There is no project in that path. Inspect itself needs projectsAcl:LIST and groupsAcl:LIST'). Repeated 'do not wait' phrasing reads as deliberate emphasis of one critical rule, not padding.

5 / 5

Actionability

Mostly executable: concrete CLI command ('npx @cognite/cli@latest apps setup-https') and two copy-paste-ready HTTP requests with exact paths and query params, plus specific field-level instructions ('find appHostingAcl (camelCase)', 'Filter projectScope... Actions are READ | WRITE | RUN'). Minor gaps remain — the <session> bearer token source and the localhost serve command are left to the Fusion prompt without a pointer to where they come from.

4 / 5

Workflow Clarity

Seven clearly sequenced numbered sections with explicit parallelism rules ('Missing appHostingAcl WRITE is a parallel track, not a gate', 'Do not wait for access before scaffolding') and explicit error-recovery checkpoints ('If the response is 403, treat access as unknown and keep going', 'If browser login stalls, loops, or never persists a session, stop and ask the builder').

5 / 5

Progressive Disclosure

The body is a well-organized overview with clearly signaled one-level-deep references to sibling skills for detail ([setup-flows-auth], [connect-atlas-mcp], [dm-graph-traversal], [flows-app-brief], [flows-external-app-submit]) and external doc links; no bundle files exist to inline, and nothing that belongs in a separate file is inlined.

5 / 5

Total

19

/

20

Passed

Description

92%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: third-person voice, explicit MUST-use and Use-whenever trigger clauses, and a concrete inventory of owned actions. The only weakness is that the trigger list leans on exact technical terms without natural synonyms.

DimensionReasoningScore

Specificity

The description enumerates concrete, specific actions covering the whole workflow: 'local HTTPS (apps setup-https)', 'GET token/inspect and appHostingAcl WRITE', 'the models/datamodels fallback', 'SME story, App-Brief', 'deploy, sign as builder, and submit' — comprehensive coverage with no vague padding.

5 / 5

Completeness

Both what and when are explicitly answered: 'MUST be used when starting a new Flows custom app' plus the concrete trigger list ('Use whenever the user mentions token/inspect, appHostingAcl, mkcert, apps setup-https, SME story, or a clickable https://localhost prototype'), alongside a clear statement of what the skill owns.

5 / 5

Trigger Term Quality

Good keyword coverage in the explicit trigger clause ('Use whenever the user mentions token/inspect, appHostingAcl, mkcert, apps setup-https, SME story, or a clickable https://localhost prototype'), but it lacks natural synonyms/variations users might say (e.g., 'deploy', 'submit', 'CDF app', 'hosted app') as triggers.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (Flows custom app bootstrap, 'Owns what the short Fusion prompt leaves out') and explicitly hands off overlapping concerns ('Hands Industrial MCP connection to connect-atlas-mcp'), minimizing conflict risk with sibling skills.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 5 suspicious

Warning

Total

14

/

16

Passed

Repository

cognitedata/builder-skills

Path

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