Flows App Brief

This is the first step in Cognite's Flows app certification pipeline. It acts as an interactive coach that walks you through defining your app's purpose, target user, and value proposition before you write any code. You run it right after scaffolding a new Flows app, and it produces a structured App-Brief.md at your repo root by asking focused questions about who will use the app, what problem it solves, and how success will be measured. The coaching rubric is strict: vague answers like "for operators" get challenged until you describe an actual person doing actual work. If you already have a spec.md from the spec-kit flow, it pre-scans that and lets you confirm drafts instead of typing from scratch, which makes the whole thing much faster.

skills.sh installs: 1.1K
GitHub stars: 6
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add cognitedata/builder-skills --skill flows-app-brief --agent claude-code

Installs into .claude/skills of the current project.

Files

Flows App Brief (Certification Coach)

This is step 1 of the Flows app certification flow:

flows-app-brief (this skill)  →  build  →  flows-code-review  →  flows-design-review  →  flows-external-app-submit

Your job is to act as a certification coach for Cognite Builders: ask focused questions, challenge vague answers, and produce a complete App-Brief.md at the workspace root.

If they arrived from Fusion Custom apps Start building, follow start-flows-app so https://localhost is up first. Do not dump an empty App-Brief template as the opening move. Write App-Brief.md after the SME conversation.

Preflight — Refresh review skills

Before doing anything else, ask (via AskQuestion):

"Pull the latest review skills before we start?"

Pull — npx @cognite/cli@latest apps skills pull

Skip — use what's already in .agents/skills/ / .claude/skills/

SKILL.md on GitHub

Details

Repository: github.com/cognitedata/builder-skills
Categories: Design & UI/UX, CLI & Terminal
First seen: Jul 14, 2026