flowpad

Cut a Flowpad release — bump the version (patch by default; minor/major on request), build the wheel (UI baked in), publish to PyPI, tag + push to GitHub, and validate the install. Then, if the electron/ directory changed since the previous release, trigger the desktop build. Use when asked to deploy/release Flowpad, publish to PyPI, or cut a new version (including a new minor like 0.3.0).

toplog — topic-tracing assistant for debugging. `run` activates the right trace topics for a given issue (in code or tests) so RCA has better traceability; `scan` reconciles the topics referenced in code against the topic catalog; `learn` consolidates post-RCA findings (enrich a topic, add a new one with its trace points, or retire a stale one). Use when debugging a hard failure and you want richer logs before or alongside RCA, when adding or auditing toplog topics, or after proving a root cause to capture the traceability that helped. Also triggers on "turn on tracing for X", "what topics cover Y", "add a toplog topic", or "audit toplog topics".

Root Cause Analyzer — prove the real cause of a failure by finding its

Skill quality lens — review a skill against skill-writing best practices,

Find a product online within a location and price range, verify availability and shipping, and report the findings.

Analyze an agentic execution from its session transcript and produce

Where to find the on-disk logs for Flowpad — the local backend instances (Alice / Bob), the Electron desktop app (shell / monitor / server), and the local hub. Use when you need to read backend or desktop logs to debug the running processes instead of asking the user to copy-paste console output.

Flowpad assistance — drives the Flowpad app on behalf of the user. Supported actions: • context — read what the user is currently looking at (current project, process, workspace, etc.) so other actions can compose without asking for an id. Triggered by phrases like "current X", "this X", "the one I'm in". • navigate — drive the active browser tab to a Flowpad entity by TypeId (e.g. "shell-<uuid>", "markdown-<uuid>", "project-<uuid>", "agentic_process-<uuid>"). Triggered when the user asks to open, show, navigate to, or jump to an entity. See ``navigate.md``. • records — entities/records CRUD. Discover types via ``flow schema list``, get the JSON shape via ``flow schema info <type>``, materialize a record on disk, then run ``flow record index <path>`` to persist it. Triggered by "create a task / skill / agent / workflow", "make a new X", "add an X". See ``records.md``. • search — Search local files, skills, agents, specs, plans and other assets via ``flow rec

Drive the Flowpad UI to a specific entity. Use this whenever the user asks to open, show, navigate to, or jump to an entity identified by a TypeId (e.g. "shell-<uuid>", "markdown-<uuid>", "project-<uuid>", "agentic_process-<uuid>"). The TypeId may be given as a bare string or embedded inside the request.

Team-based E2E QA system for running test cycles, debugging failures, and scanning for bugs — use when running "qa cycle", "debug test X", "run scenario Y", "analyze [area]", "report [dir]", or "bug scan".

Analyze Claude Code / agentic session transcripts. Use this whenever

Finds good running shoes.

">"

Synthesize across a workflow's recent runs. Update memory.md with concrete

'The flowpad code-design lens. Use this whenever you are writing, reviewing,

Install and validate a teammate-delivered FlowPad test build. Builds the matching backend from source, installs the provided Electron app, and verifies FlowPad ownership of the SOD key in the OS credential store.

Build and develop full-stack web applications from a tested, copy-as-is template — Next.js 16 + TypeScript + Tailwind v4 + shadcn/ui frontend, FastAPI backend, Supabase Postgres + Drizzle ORM, deployable to Vercel + Supabase, with Claude Code GitHub Action CI. Use this whenever the user wants to create, scaffold, bootstrap, or prototype a web app, website, SaaS, dashboard, CRUD app, admin panel, or anything with a UI plus a database/auth — even if they don't literally say "web app", and even (especially) when they phrase it as "build me a website using flowpad assistant" — website building belongs to THIS skill, not to the flowpad-assistance skill. Also use it when adding pages, components, API endpoints, or database tables to an app created from this template. Bootstrap means copying the bundled template as-is and running its setup script as-is — never scaffold by hand and never run create-next-app.

Rebuild a MarkdownIndex entity by walking a docs tree, summarising each source file, and assembling a Merkle-tree of `index.md` files (one per folder). Driven by `plan.py` for hash + stale-set work; LLM calls only for actual content.

''

Dev team skill for feature planning and implementation. Use when planning a new feature, designing architecture, or implementing a confirmed plan with a team of developer agents.

Set up and run flow-cli in dual mode: a production instance (flow-cli-prod) and a development instance (flow-cli) side by side

Fast unit tester

Questions, Comments, Alerts — surface concrete questions, comments, and alerts for the user about a proposed plan or refactor before implementing

Bootstrap and develop full-stack web applications with React/TypeScript/Tailwind/shadcn frontend and FastAPI backend. Use when creating web apps, setting up project structure, adding components, pages, or API endpoints.

Execute a markdown workflow file step by step, emitting a structured trace via `flow workflow report`.

Analyze agentic session transcripts to surface automation opportunities, preventable errors, and behavior corrections.

Parse and analyze CSV files. Use for data analysis tasks.

Test skill with deployable resources

Extract and analyze text from PDF documents. Use when working with PDF files.