
Flows External App Submit
Finalize a Cognite Flows external app for certification by verifying prior review artifacts then running the CLI submit step.
Install
npx skills add https://github.com/cognitedata/builder-skills --skill flows-external-app-submitWhat is this skill?
- Final step 4 in the Flows certification chain: brief → build → code review → design review → submit
- Does not rerun reviews—verifies App-Brief.md, latest code-review report (Must Fix open: 0), and design report (average ≥
- Runs `npx @cognite/cli apps submit` to zip the repo and pre-populate the external submission form
- Shows a preflight checklist to the user before any CLI invocation
- Allowed tools include Read, Glob, Grep, Bash, AskQuestion, Write for artifact verification and submit
Adoption & trust: 278 installs on skills.sh; 4 GitHub stars; trending (+100% hot-view momentum).
Recommended Skills
Release Skillsjimliu/baoyu-skills
Changelog Automationwshobson/agents
Msstore Cligithub/awesome-copilot
Changelog Generatorcomposiohq/awesome-claude-skills
Shopify App Store Reviewshopify/shopify-ai-toolkit
Shipping And Launchaddyosmani/agent-skills
Journey fit
Primary fit
External certification submit is a launch-prep ship action: it packages the repo and pre-fills the submission form after quality gates pass. Launch subphase fits because the skill's outcome is submitting the app for external review, not writing new product code.
SKILL.md
READMESKILL.md - Flows External App Submit
# Flows External App Submit This is **step 4** (final) of the Flows app certification flow: ``` flows-app-brief → build → flows-code-review → flows-design-review → flows-external-app-submit (this skill) ``` This skill **does not** rerun any review. It verifies the artifacts from the prior three steps and only then invokes the CLI submit command. ## Preconditions (show these to the user first) Before doing anything, print this checklist so the user knows exactly what is being verified: 1. `App-Brief.md` exists at repo root and all **required** frontmatter fields are populated. 2. The latest `reviews/code-review/feedback-round-<N>/code-review-report.md` is **committed to git** and reports **`Must Fix open: 0`**. 3. The latest `reviews/design-review/feedback-round-<N>/design-review-report.md` is **committed to git** and reports **`Average score: X.X`** with **X.X ≥ 3.8**. 4. Certification artifacts are committed — `apps submit` uses `git archive HEAD` and silently excludes uncommitted files. 5. A deploy bundle exists in `.cognite-bundles/` and is not older than HEAD. ## Step 0 — Air-hatch preflight (offer stubs if reviews are missing) `App-Brief.md` is non-negotiable — it captures the value case the certification reviewer reads first. The code and design reviews, however, can be air-hatched with a clear "SKIPPED" status that the reviewer will see and act on. Use this when the user wants to submit without spending the 20+ minutes each review takes. Probe for each review artifact via `git ls-files`: ```bash git ls-files 'reviews/code-review/' | grep -q 'code-review-report.md' && echo code_present || echo code_missing git ls-files 'reviews/design-review/' | grep -q 'design-review-report.md' && echo design_present || echo design_missing ``` - Both reports present → skip Step 0, continue at Step 1. - `App-Brief.md` missing → continue to Step 1, which fails with the standard "Run `flows-app-brief` first" message. The air-hatch does **not** cover App-Brief. - Either review missing → offer the air-hatch via `AskQuestion`: > "Review artifacts missing: <list which>. Choose: > > - **Run real reviews** — exit here; user runs `flows-code-review` / `flows-design-review` first (~20 min each). Recommended for first-time submissions. > - **Quick submit (stubs)** — write SKIPPED stub reports for the missing reviews. The Cognite certification reviewer will see the SKIPPED status and request real reviews before approval, but you can submit now. > - **Cancel** — stop without doing anything." On **Run real reviews**: print the next-step command (`flows-code-review` and/or `flows-design-review`) and exit. On **Cancel**: exit. On **Quick submit**: for each missing review, write the stub using the templates in "Stub templates" at the end of this skill: - `reviews/code-review/feedback-round-0/code-review-report.md` - `reviews/design-review/feedback-round-0/design-review-report.md` Round 0 is intentional — real review skills start at `feedback-round-1`. When the user later runs a real review, `sort -V | tail -1` picks the higher round number, so the stub is automatically superseded without manual cleanup. After writing the stubs, tell the user: > "Stub reports written. Commit them along with `App-Brief.md`, then re-run this skill: > > git add App-Brief.md reviews/ > git commit -m 'chore: certifica