CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

flows-app-brief

Certification coach for Flows apps. Captures the app name, value case, persona, problem, and design intent through a structured conversation and writes App-Brief.md at the repo root. Write the brief after the SME conversation — do not dump an empty template as the opening move. If they came from Fusion Custom apps Start building, follow start-flows-app so https://localhost is up first. Use when the user asks to start an app brief, run the certification coach, fill out the app brief, or run flows-app-brief.

67

Quality

84%

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

81%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 highly actionable, well-sequenced coaching skill: concrete commands, a complete output template, explicit validation gates, and feedback loops at every failure point. Its only notable weakness is redundancy — the opening-move rule and the batch-confirmation rule are each stated twice — plus a template block that could arguably be a reference file in an otherwise lean single-file body.

Suggestions

Remove the duplicated guidance: keep the "write the brief after the SME conversation / do not dump an empty template" rule in one place (the intro) and delete its restatement in Operating rules; likewise consolidate the batch-confirmation rule from Operating rules bullet 2 with the near-identical paragraph closing the Spec-kit mapping section.

Consider moving the full App-Brief.md template block (Step 4) into a reference file (e.g. references/app-brief-template.md) and keeping only the required/optional field list inline, so the body stays a lean overview with one clearly signaled reference.

Trim the repeated preflight options between the blockquote ("Pull / Skip") and the numbered recovery path ("Retry / Skip and continue / Stop") so each choice and consequence is stated exactly once.

DimensionReasoningScore

Conciseness

Mostly efficient and free of concept over-explanation, but real duplication exists: the "do not dump an empty template as the opening move" / "write the brief after the SME conversation" rule appears both in the intro paragraph and in Operating rules, and the batch-confirmation guidance for spec-derived drafts is stated twice in near-identical words (Operating rules bullet 2 and the close of Spec-kit mapping). Not 4 because these are more than minor trimmings — whole sentences and one full bullet are redundant; not 2 because there is no padding or teaching of known concepts and every section carries functional weight.

3 / 5

Actionability

Fully executable guidance throughout: exact commands (`npx @cognite/cli@latest apps skills pull`, `Glob '**/skills/correctness-and-error-handling/SKILL.md'`), a complete copy-paste-ready App-Brief.md template with exact YAML frontmatter, scripted challenge questions in quotes, concrete good examples for each coached field, and the exact closing message. Matches the anchor for copy-paste-ready, specific examples covering common cases.

5 / 5

Workflow Clarity

Clear Step 0–5 sequence with explicit validation checkpoints and feedback loops: the preflight sentinel glob with "Zero matches → ask: Retry / Skip and continue / Stop", challenge-and-re-ask loops per coached field, and the hard gate "If any required field is still empty, do not write the file — return to coaching that field". Error recovery paths are explicit at every failure point.

5 / 5

Progressive Disclosure

Well-organized single-file structure with clear section headers, and the one external reference ([start-flows-app](../start-flows-app/SKILL.md)) is well-signaled and one level deep; no bundle files exist so nothing is buried. Not 5 because at ~215 lines some self-contained blocks (e.g. the 55-line output template, the field-by-field coaching rubric) could live in a reference file to keep the SKILL.md body a leaner overview; not 3 because nothing that clearly belongs elsewhere is inlined and navigation is easy.

4 / 5

Total

17

/

20

Passed

Description

83%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, concrete capture-and-write actions, an explicit "Use when..." trigger clause, and a distinct niche within the Flows certification flow. The main gaps are minor — slightly incomplete action coverage and a little overlap risk with sibling certification skills.

DimensionReasoningScore

Specificity

Names the domain (Flows app certification) and several concrete actions — "Captures the app name, value case, persona, problem, and design intent through a structured conversation and writes App-Brief.md at the repo root" — but coverage of the coaching process is incomplete (challenging vague answers, confirming pre-scanned drafts are only implied). Not 5 because the action list has minor gaps; not 3 because it goes beyond 1-2 actions to list the captured fields and the concrete output artifact.

4 / 5

Completeness

Both what and when are explicitly and clearly answered: what — captures five brief fields via structured conversation and writes App-Brief.md; when — an explicit "Use when the user asks to..." clause listing four concrete triggers. Matches the anchor for clearly answering both with concrete trigger phrases.

5 / 5

Trigger Term Quality

Explicit trigger phrases — "Use when the user asks to start an app brief, run the certification coach, fill out the app brief, or run flows-app-brief" — cover the natural phrasings a user would say. Not 5 because common synonyms like "create an app brief", "app brief template", or "certification flow" variants are missing; not 3 because multiple natural phrasings and the skill's own name are present rather than a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Flows app certification brief) with distinct triggers ("app brief", "flows-app-brief", "App-Brief.md") that separate it from the sibling build/review/submit skills in the same flow. Not 5 because "run the certification coach" and "certification" language overlaps mildly with the other certification-flow skills (flows-code-review, flows-design-review, flows-external-app-submit); not 3 because the file artifact and skill name make false triggers unlikely.

4 / 5

Total

17

/

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: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

cognitedata/builder-skills

Path

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