CtrlK
BlogDocsLog inGet started
Tessl Logo

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. This is the FIRST step of the Flows app certification flow — run it immediately after `npx @cognite/cli apps create`, before building. Use when the user asks to start an app brief, run the certification coach, fill out the app brief, or run flows-app-brief.

72

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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 clear sequenced workflows and validation feedback loops, and it avoids explaining concepts Claude already knows. The main weaknesses are modest verbosity and a monolithic single-file structure with no progressive offloading to reference files.

Suggestions

Tighten the operating rules and step introductions to reduce repetition with the coaching discipline already stated earlier, shaving length toward a leaner body.

Consider splitting the per-field coaching rubrics (Step 3) and the exact App-Brief.md template (Step 4) into a reference file so SKILL.md reads as a concise overview pointing one level deep to detailed materials.

Audit for any remaining redundancy between the preflight section and the operating rules to further improve token efficiency.

DimensionReasoningScore

Conciseness

The body is mostly efficient and assumes Claude's competence (no basic-concept padding), but at ~225 lines it is fairly long and restates coaching discipline in both the operating rules and step intros; a few passages could be tightened.

2 / 3

Actionability

It provides concrete, copy-paste-ready guidance throughout — exact AskQuestion phrasing, challenge prompts, precise shell commands, and an exact YAML/markdown template — fully actionable for an instruction-only skill.

3 / 3

Workflow Clarity

Steps 0–5 are clearly sequenced with explicit validation checkpoints: the preflight sentinel Glob verifies the skills pull, and Step 4 refuses to write the file when required fields are empty, returning to coaching instead.

3 / 3

Progressive Disclosure

No bundle files exist, and the body is a single self-contained file; it is well-organized into sections but everything is inline with no offloading to reference files, so the structure is good but not a lean overview pointing to detailed materials.

2 / 3

Total

10

/

12

Passed

Description

100%

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 excellent: third-person voice, concrete actions, explicit 'Use when' triggers, and a clearly distinct certification-coach niche. It fully satisfies all four dimensions at the top anchor.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Captures the app name, value case, persona, problem, and design intent', 'writes App-Brief.md at the repo root', and 'structured conversation' — matching the top anchor for specific concrete actions.

3 / 3

Completeness

It explicitly answers both what the skill does (coach + capture fields + write App-Brief.md) and when to use it via an explicit 'Use when...' trigger clause with sequencing context.

3 / 3

Trigger Term Quality

The 'Use when the user asks to start an app brief, run the certification coach, fill out the app brief, or run flows-app-brief' clause gives good coverage of natural phrasings a user would actually say.

3 / 3

Distinctiveness Conflict Risk

The niche is specific (Flows app certification flow, App-Brief.md) with distinct triggers tied to that niche, making conflict with other skills unlikely.

3 / 3

Total

12

/

12

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

allowed_tools_field

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

Warning

Total

15

/

16

Passed

Repository
cognitedata/builder-skills
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.