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.

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.

The body is an exceptionally actionable coaching workflow: every step has verbatim prompts, exact option lists, validation gates, and a complete output template, with clear sequencing and error-recovery loops. Its weaknesses are repetition — re-run-mode rules and the 'never invent' rule each appear three times — and an inlined full file template that would fit better in a separate reference file.

Suggestions

Consolidate the re-run-mode rules (currently duplicated in 'Operating rules', Step 0 rule 4, and 'Re-run mode for support fields') into a single 'Re-run mode' section, and state the 'never invent' rule once at the top instead of three times.

Move the full App-Brief.md template (~65 lines in Step 5) to a references/ or assets/ file (e.g. references/app-brief-template.md) and keep only the required/optional field checklist inline in SKILL.md.

Trim the Step 2 instructions, which repeat the required/optional field lists twice within the same section (bulleted list plus the opening-message paragraph).

DimensionReasoningScore

Conciseness

The body is mostly efficient domain-specific guidance, but the re-run-mode rules for existing App-Brief.md files are repeated nearly verbatim in three places (Operating rules bullet, Step 0 rule 4, and the 'Re-run mode for support fields' section), and 'never invent' is stated three times — clear cases where it could be tightened. It is above 2 because there is no explanation of concepts Claude already knows; the length comes from real domain content plus duplication.

3 / 5

Actionability

Fully executable instruction-only guidance: verbatim challenge prompts per coached field, exact commands ("npx @cognite/cli@latest apps skills pull"), a sentinel glob pattern, fixed four-option supportPath choices, and a copy-paste-ready App-Brief.md template with exact YAML frontmatter. Specific examples (the shift-supervisor persona, the handover problem) cover the common cases.

5 / 5

Workflow Clarity

The Preflight through Step 6 sequence is explicit, with validation checkpoints and feedback loops: the skills-pull sentinel check offers Retry/Skip/Stop, and Step 5 refuses to write the file and returns to coaching while any required field is empty. It also handles the re-run and edge cases (single maintainer warning, string-vs-list maintainer). Not a destructive or batch operation, so no cap applies.

5 / 5

Progressive Disclosure

A single-file skill with no bundle directories, well-organized under numbered step headers and tables, and one clearly signaled one-level-deep reference ([start-flows-app](../start-flows-app/SKILL.md)). It is not a 5 because the ~65-line output template in Step 5 is content that could be split into a reference/asset file, keeping SKILL.md as a leaner overview.

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: it names concrete actions, names the output artifact, and closes with an explicit 'Use when' clause covering four trigger phrasings. The main weakness is embedded procedural instruction (ordering directives, localhost precondition) that inflates length without improving discoverability, and a few missing natural trigger variants.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Captures the app name, value case, persona, problem, and design intent", "writes App-Brief.md at the repo root", "follow start-flows-app" — placing it at the 'several specific actions; minor gaps' anchor. It falls short of 5 because procedural asides ("do not dump an empty template as the opening move", "so https://localhost is up first") pad the capability list rather than broaden coverage.

4 / 5

Completeness

It explicitly answers both what ("Captures the app name, value case, persona, problem, and design intent... and writes App-Brief.md") and when ("Use when the user asks to start an app brief, run the certification coach, fill out the app brief, or run flows-app-brief") with concrete trigger phrases, matching the top anchor. A 4 would require the 'when' clause to be less explicit, which is not the case here.

5 / 5

Trigger Term Quality

"Use when the user asks to start an app brief, run the certification coach, fill out the app brief, or run flows-app-brief" gives good keyword coverage of natural phrasings. It is not a 5 because common variations such as "create an app brief" or "app briefing" are missing.

4 / 5

Distinctiveness Conflict Risk

"Certification coach for Flows apps" carves a clear niche with flow-specific triggers ("flows-app-brief", "certification coach"), but it sits in a five-skill certification pipeline where sibling skills (build, code-review, design-review) could plausibly fire on adjacent phrasings — minor overlap risk with closely related skills. Not a 5 because the niche is distinct but the pipeline context creates some adjacency.

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.