cognitedata/builder-skills
26 skills44.5k installs130 starsGitHub
Install
npx skills add https://github.com/cognitedata/builder-skillsSkills in this repo
1Skill Creatorskill-creator from cognitedata/builder-skills implements a Post-hoc Analyzer agent that runs after a blind comparator picks winner A or B. It unblinds results by reading winner_skill_path, loser_skill_path, winner_transcript_path, and loser_transcript_path supplied in the prompt. The analyzer extracts why the winner succeeded, what the loser missed, and actionable edits to close the gap. Developers and agent authors reach for skill-creator when iterating SKILL.md instructions, tool use patterns, or workflow structure based on paired execution evidence rather than intuition. It complements blind testing infrastructure by turning comparison outcomes into specific skill rewrite guidance.2.5kinstalls2Code QualityReview ARGUMENTS or the whole app if no argument is given for code quality issues Work through every step below in order and report all findings with file paths and line numbers Before reading any code manually get a baseline from the automated tools List every error and warning Fix all errors before proceeding lint errors are not negotiable Warnings should be reviewed and resolved unless there is a documented exception Also run the TypeScript compiler in strict mode to surface any hidden type issues List every type error These must be fixed The code quality agent skill provides documented workflows prerequisites triggers and safety guidance from its SKILL md source Agents load it when user requests match the description and follow step by step instructions without inventing capabilities It integrates with standard agent tooling for the tasks inputs outputs and failure modes described in the repository documentation1.9kinstalls3Dependencies AuditFind and fix all dependency issues in ARGUMENTS or the root package json if no argument is given vulnerabilities outdated packages deprecated dependencies license problems and supply chain risks This skill produces the review packages md artifact required by the Flows app review process Step 1 Read and list all dependencies bash List all dependencies and devDependencies node e const pkg require package json console log Dependencies Object entries pkg dependencies forEach name ver console log name ver console log n Dev Dependencies Object entries pkg devDependencies forEach name ver console log name ver Record the total count of dependencies and devDependencies Step 2 Look up npm metadata and update outdated packages The dependencies audit agent skill provides documented workflows prerequisites triggers and safety guidance from its SKILL md source Agents load it when user requests match the description and follow step by step instructions without inventing capabilities It integrates with standard agent tooling for the tasks inputs outputs and failure modes described in the repository documentation1.9kinstalls4Test CoverageFix test coverage for ARGUMENTS or the whole app if no argument is given This skill enforces the 80 line coverage hard gate required for Flows app approval by finding AND fixing coverage gaps Work through every step in order Step 1 Verify test framework and coverage tooling Check that the project has a working test framework with coverage configured bash Check for vitest or jest in package json grep E vitest jest package json Check for coverage configuration cat vitest config ts 2 dev null cat vitest config js 2 dev null cat jest config ts 2 dev null cat jest config js 2 dev null The test coverage agent skill provides documented workflows prerequisites triggers and safety guidance from its SKILL md source Agents load it when user requests match the description and follow step by step instructions without inventing capabilities It integrates with standard agent tooling for the tasks inputs outputs and failure modes described in the repository documentation1.9kinstalls5Reveal 3dAdd a Cognite Reveal 3D viewer to a Flows app by copying the bundled source into the target app Renders CAD models from CDF with support for model browsing direct model revision IDs or FDM linked assets FDM instance to visualize ARGUMENTS The user wants to embed an interactive Cognite Reveal viewer for CDF 3D CAD content in a Flows app Do not use this skill for static diagrams graph visualizations or unrelated custom Three js scenes The app uses React TypeScript and is wrapped in cognite dune auth Flows auth The app has a QueryClientProvider from tanstack react query The CDF project has 3D models or the user has supplied direct model revision IDs For FDM linked 3D the instance must be linked through Core DM CogniteVisualizable object3D CogniteCADNode1.9kinstalls6DesignUse Aura as the default UI system for customer facing product work Prefer decision level guidance over exhaustive rules choose the right primitive first apply semantic tokens no raw values keep layouts and UX states consistent write concise action oriented copy Use Storybook for component APIs and exact props Use this skill for what to choose and when Aura Design Guidlines can be found at node_modules cognite aura DESIGN md Creating or migrating interactive UI forms tables navigation or data display Writing or modifying styles colors spacing or typography Choosing components tokens or layout patterns Creating or restructuring pages and responsive layouts Writing or editing any user facing text Building forms handling API responses async actions confirmations or dynamic content Implementing accessibility keyboard focus headings ARIA alt text Applying Aura correctly in a Flows or React app If you are Open Choosing primitives and deciding what to use when primitive usage md Where to look for Storybook docs and Figma router picking components md Structuring a page or choosing a1.9kinstalls7Integrate Todo ListAdd a structured task tracking feature to this Flows app The agent will use a TodoWrite tool to create and update a task list as it works through multi step queries giving the user real time visibility into what the agent is doing and why Prerequisite integrate atlas chat must already be complete useAtlasChat must be wired typically from atlas agent react src atlas agent must contain the vendored atlas agent sources and sinclair typebox must be installed per that skill package json confirm tabler icons react is installed if not install it with the app s package manager src App tsx find where to add TodoProvider The file that calls useAtlasChat likely src chat useChatViewModel ts or src App tsx this is where the tool gets wired The chat view component that renders messages this is where TodoPanel and TodoToolResultCard go Step 2 Create the src todo module Find the skill directory by running find path agents skills integrate todo list code type d from the project root1.9kinstalls8Correctness And Error HandlingFind and fix correctness issues and missing error handling in ARGUMENTS or the whole app if no argument is given Work through every step below Each step searches for problems and then fixes them in place Only report issues that cannot be auto fixed Step 1 Map data flows and fix known defects Read these files before checking anything src main tsx src App tsx top level error boundaries and auth flow All files matching hooks ts contexts tsx shared async state All files matching api ts services ts CDF SDK call sites For each async data source note What happens when the request fails network error CDF 403 timeout What does the UI show while loading What does the UI show if the result is empty The correctness and error handling agent skill provides documented workflows prerequisites triggers and safety guidance from its SKILL md source Agents load it when user requests match the description and follow step by step instructions without inventing capabilities It integrates with standard agent1.9kinstalls9Dm Limits And Best PracticesCDF Data Modeling Limits Concurrency Best Practices This is a reference skill When writing or reviewing code that calls CDF Data Modeling APIs apply the patterns below This skill owns runtime reliability concerns limits concurrency retries throughput and batching behavior For traversal payload correctness and graph specific failure signatures see dm graph traversal For the latest concurrency limits resource limits and property value limits see the official documentation https docs cognite com cdf dm dm_reference dm_limits_and_restrictions Key things to be aware of Instance apply delete and query operations each have their own concurrent request limits Exceeding these limits returns 429 Too Many Requests Transformations consume a large portion of the concurrency budget leaving less for other clients instances list has a max page size use pagination for complete results instances query table expressions each have their own item limit instances upsert accepts up to 1000 items per call in filters accept at most 1000 values per expression larger sets must be split into batches1.9kinstalls10Integrate Atlas ChatFollow the guide at https docs cognite com cdf flows guides ai_agent_integration to add a streaming Atlas Agent chat UI to this Flows app The integrate atlas chat agent skill provides documented workflows prerequisites triggers and safety guidance from its SKILL md source Agents load it when user requests match the description and follow step by step instructions without inventing capabilities It integrates with standard agent tooling for the tasks inputs outputs and failure modes described in the repository documentation1.9kinstalls11Integrate File ViewerAdd CogniteFileViewer to this Flows app to preview CDF files PDF image text The file viewer library files copied in Step 2 require this npm package Package Version react pdf 9 1 1 pdfjs dist ships as a dependency of react pdf at the correct version do not install it separately react and cognite sdk are assumed to already be present in Flows apps Complete these steps in order Read each file before modifying it The integrate file viewer agent skill provides documented workflows prerequisites triggers and safety guidance from its SKILL md source Agents load it when user requests match the description and follow step by step instructions without inventing capabilities It integrates with standard agent tooling for the tasks inputs outputs and failure modes described in the repository documentation1.9kinstalls12SecurityFind and fix security issues in ARGUMENTS or the whole app if no argument is given Work through every step below in order Every step that finds an issue must also fix it Read these files before checking anything src main tsx src App tsx entry point routing auth gating vite config ts dev server proxy CORS headers package json list of third party dependencies Any file matching auth login token credential Identify All pages routes and whether each is behind an auth guard All places where external data enters the app CDF SDK calls fetch user form input All places where data is written back CDF upsert fetch POST PUT DELETE Step 2 Migrate all CDF access to the Cognite SDK The security agent skill provides documented workflows prerequisites triggers and safety guidance from its SKILL md source Agents load it when user requests match the description and follow step by step instructions without inventing capabilities It integrates with standard agent tooling for the tasks inputs outputs and failure1.9kinstalls13Graph ViewerThe user wants to embed an interactive graph of a CDF data model nodes direct relations edges and reverse relations inside a Flows app Do not use this skill for static diagrams pure dataflow visualizations or non CDF graphs The app is wrapped in cognite dune s DuneProvider so useDune returns an authenticated SDK The target data model exists in CDF and you know its space externalId and version The app uses React 18 and TypeScript Follow these steps in order Adapt to the target repo s conventions instead of inventing new ones 1 Inspect the target app Read package json and look at the existing folder structure e g src features src components path aliases like 2 Install missing dependencies with the app s package manager npm pnpm yarn See the Dependencies dependencies table below for purposes and suggested versions Reuse the React version already pinned by the app rather than upgrading it and prefer any versions the repo already pins over the suggestions here 3 Copy the bundle1.9kinstalls14Setup Flows AuthWire a React app for Flows auth so it can talk to CDF inside Fusion Two flows exist pick one based on app json app json infra Flow Auth source Extra package appsApi Apps API new Fusion app host connectToHostApp from cognite app sdk cognite app sdk missing other Classic legacy Files API DuneAuthProvider useDune from cognite dune No app json Ask the user Default to Apps API it s the default for npx cognite cli latest apps create Step 1 Read state decide whether to act Read package json src main tsx or src index tsx vite config ts app json The setup flows auth agent skill provides documented workflows prerequisites triggers and safety guidance from its SKILL md source Agents load it when user requests match the description and follow step by step instructions without inventing capabilities It integrates with standard agent tooling for the tasks inputs outputs and failure modes described in the repository documentation1.9kinstalls15Setup Python ToolsAdd client side Python tool execution via Pyodide to this Flows app integrate atlas chat must already be complete the app should have vendored atlas agent code under src atlas agent including react ts for useAtlasChat and the peer dependency from that skill sinclair typebox Copy the Python related modules from the integrate atlas chat skill code directory into src atlas agent when adding Pyodide python ts pyodide ts pyodide react ts pyodide runtime ts see integrate atlas chat Step 5 Atlas agents can have Python tools defined in their CDF config type runPythonCode When the agent calls one it arrives as a toolConfirmation auto allowed followed by a clientTool action The library fetches the tool s Python code from the agent config automatically and executes it via the provided pythonRuntime You only need to 1 Set up usePyodideRuntime to get a runtime instance 2 Pass pythonRuntime to useAtlasChat No PythonToolConfig entries the library reads the code from the agent s CDF config1.9kinstalls16Create Client ToolScaffold a new AtlasTool named ARGUMENTS and wire it into the app integrate atlas chat must already be complete the app should vend the atlas agent sources under src atlas agent including react ts and have sinclair typebox installed as in that skill Client tools let the Atlas Agent invoke logic that runs in the browser rendering charts querying local state showing UI panels triggering navigation etc The agent decides when to call the tool the app executes it and returns a result The flow is 1 Agent responds with a clientTool action 2 The library validates the arguments against the TypeBox schema 3 execute runs in the browser and returns output details 4 output string is sent back to the agent as the tool result 5 details any shape is available on message toolCalls for the UI to render The file where useAtlasChat is called often src App tsx or a chat hook to find where tools is passed imports are typically from atlas agent react after integrate atlas1.9kinstalls17PerformanceSystematically find and fix performance issues in ARGUMENTS or the whole app if no argument is given Always measure first never optimize blindly Step 1 Measure baseline before touching anything Run the production build and capture metrics before making any changes bash pnpm run build pnpm run preview Open the app in Chrome and capture Lighthouse score Performance tab Run audit React Profiler React DevTools Profiler Record an interaction Note the components with the longest render times and highest render counts The performance agent skill provides documented workflows prerequisites triggers and safety guidance from its SKILL md source Agents load it when user requests match the description and follow step by step instructions without inventing capabilities It integrates with standard agent tooling for the tasks inputs outputs and failure modes described in the repository documentation1.9kinstalls18Pull Changes Resolve ConflictsUse this skill whenever integrating another branch usually main into the current feature branch or when git status shows unmerged paths after a merge or rebase Applies to any Git based team workflow Flows React apps are a common case where conflicts cluster in app shells and shared libraries Preserve intentional work on the current branch do not assume main wins or ours wins without analysis Make trade offs visible to the user before any conflict resolution edits Order discussion by impact structural feature API data model changes before styling copy or spacing 1 No silent resolution Do not remove or run git add on conflicted files until the user has agreed to the plan or explicitly says use your recommendations 2 Stop at conflicts If a merge or rebase introduces conflicts pause and report do not bulldoze through large files by picking one side wholesale unless the user explicitly requests that 3 Prioritize impact When presenting conflicts group and order roughly as P0 Structural product removed routes deleted modules1.9kinstalls19Use Topbaraura topbar is the single compliant top navigation bar for every authenticated Flows Fusion app It is a shadcn registry component installed via pnpm dlx shadcn latest add aura topbar not an npm package Storybook https cognitedata github io aura storybook path docs primitives topbar docs Full rules RULES md RULES md Interview INTERVIEW md INTERVIEW md Install code IMPLEMENTATION md IMPLEMENTATION md Non negotiables Exactly one Topbar per page composed only from aura topbar primitives installed via the shadcn CLI only If installation fails surface the blocker never build a custom header fallback See RULES md 1 11 12 RULES md Ensure the topbar interview is triggered at the start of every future Cursor session in this project 1 Check whether cursor hooks json exists in the project root 2 If it does not exist create it1.9kinstalls20Migrate App To FlowsThe migrate-app-to-flows skill "MUST be used when migrating a legacy Dune app to the new Flows app hosting infrastructure. Orchestrates the full migration: audits current state, updates app.json to appsApi infra, delegates auth wiring to setup-flows-auth, creates or updates manifest.json network permissions, and updates deploy scripts to @cognite/cli. Use this whenever a user says 'migrate to Flows', 'migrate to new infra', 'move from dune to flows', 'migrate legacy app', or wants to move their existing app to the new Flows app hosting." It covers use full origin scheme + hostname in sources , not just the hostname.. Key workflows include "connect-src" covers fetch / XMLHttpRequest . Use "img-src" for image URLs, "font-src" for fonts.. Developers invoke migrate-app-to-flows when the task matches the triggers and reference files in SKILL.md for grounded, stepwise execution.1.7kinstalls21Integrate Fusion AgentThe integrate-fusion-agent skill - It covers open the agent panel - a button that shows the sidebar/fullscreen agent UI. Key workflows include send the agent a message - inject context into the chat e.g. on item click. Developers invoke integrate-fusion-agent when the task matches the triggers and reference files in SKILL.md for grounded, stepwise execution. Reference files and progressive disclosure keep context focused while preserving concrete commands, configuration fields, and validation checks copied from the upstream documentation. Reference files and progressive disclosure keep context focused while preserving concrete commands, configuration fields, and validation checks copied from the upstream documentation. Reference files and progressive disclosure keep context focused while preserving concrete commands, configuration fields, and validation checks copied from the upstream documentation. Reference files and progressive disclosure keep context focused while preserving concrete commands, configuration fields, and validation checks copied from the upstream documentation.1.6kinstalls22Flows Code ReviewThe flows-code-review skill executes the technical review step of Flows app certification, producing review-files.md inventory, review-packages.md dependency audit, and code-review-report.md with Must Fix, Should Fix, and Nice Fix scored items under reviews/code-review/feedback-round-N. Pre-checks require package.json, git repository, and ideally App-Brief.md from flows-app-brief. Review loads local skills for correctness, security, dependencies-audit, test-coverage, code-quality, dm-limits, performance, and design criteria, plus setup-flows-auth when OAuth imports appear. Scoring covers bugs, CDF SDK usage, dependency CVEs, test coverage gates, dead code, DMS query patterns, pagination, and Aura consistency. Repeat until zero open Must Fix items before flows-design-review. Invoke for Flows code review, pre-submit technical review, or app certification code passes. Produces review-files, review-packages, and code-review-report artifacts. Scores Must Fix, Should Fix, and Nice Fix per certification criteria. Loads local correctness, security, test-coverage, and design skills.1.6kinstalls23Flows Design ReviewThe flows-design-review skill >- # Flows Design Review This is **step 3** of the Flows app certification flow: ``` flows-app-brief → build → flows-code-review → flows-design-review (this skill) → flows-external-app-submit ``` This is the **manual design quality assessment** described in [docs.cognite.com/cdf/flows/guides/quality-guidelines](https://docs.cognite.com/cdf/flows/guides/quality-guidelines). Target overall average: **3.8 or higher** to be launch-ready. ## Operating rules - **Automate first, ask second.** For every question Q1 - Q10, run the probes listed below to gather hard evidence from the repo and **propose a draft score (1 - 5) with rationale** *before* asking the user. The user's job is to confirm or override the proposed score, not to grade from scratch. This dramatically reduces the manual burden. - The **task walkthrough (Step 2)** is the one part that cannot be skipped - automation cannot tell whether a user "gets lost" navigating a screen. Capture it manually and use it to override the auto-derived scores where lived experience disagrees.1.1kinstalls24Flows App BriefThe flows-app-brief skill >- # 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 developers: ask focused questions, challenge vague answers, and produce a complete `App-Brief.md` at the workspace root. ## 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/` On **Pull**: 1. Run `Bash npx @cognite/cli@latest apps skills pull`. `Glob '**/skills/correctness-and-error-handling/SKILL.md'` as a sentinel. Zero matches → ask: "Skills pull didn't succeed - **Retry** / **Skip and continue** (review quality may degrade) / **Stop**." On **Skip**: continue immediately. ## Operating rules - **Coaching from scratch is one question at a time.** When you have no pre-scanned draft for a coached field and must elicit the answer fresh, use a single-question `AskQ.1.1kinstalls25Flows External App SubmitThe flows-external-app-submit skill >- # 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. The latest `reviews/code-review/feedback-round-<N>/code-review-report.md` is **committed to git** and reports **`Must Fix open: 0`**. 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**. Certification artifacts are committed - `apps submit` uses `git archive HEAD` and silently excludes uncommitted files. A deploy bundle exists in `.cognite-bundles/` and is not older than HEAD.1.1kinstalls26Dm Graph TraversalNavigates complex graph structures in Cognite data models and databases. Traverses relationships.20installs