flowstate-skills

FlowState Skills

FlowState Skills is a complete agent-driven methodology for working inside the FlowState platform — entity management, registration, multi-phase planning, task execution, code review, business plan and product creation, agent inbox triage, and process automation — packaged as a set of composable skills with the bootstrap instructions that make sure your agent uses them.

Quickstart

Give your agent FlowState Skills: Claude Code · Codex CLI · Cursor · Gemini CLI · OpenCode · GitHub Copilot CLI · Factory Droid.

How It Works

From the moment the session starts, the FlowState bootstrap skill is injected into your agent's context. The agent sees the full FlowState skill catalog and the absolute rules — never fabricate IDs, always read .flowstate/config.json before any MCP call, always resolve agent identity before dispatching subagents.

When you ask the agent to onboard a repo, build a feature, triage its inbox, or spin up a product and business plan, it reaches for the matching skill instead of guessing. Skills compose: brainstorming hands off to multi-phase planning, which hands off to task execution, which hands off to code review and branch finishing — each step gated by the right approval, identity, and time-tracking sub-skills.

The agent checks for relevant skills before any task. They are mandatory workflows, not suggestions.

Installation

Installation differs by harness. If you use more than one, install FlowState Skills separately for each.

Claude Code

FlowState Skills is distributed via the Epic Digital marketplace.

• Register the marketplace:

  /plugin marketplace add epic-digital-im/epic-flowstate-skills
  

• Install the plugin:

  /plugin install flowstate-skills@epic-flowstate
  

Codex CLI

• Open the plugin search interface:

  /plugins
  

• Search for flowstate-skills and select Install Plugin.

If FlowState Skills is not yet available in the official Codex marketplace, install directly from this repository by cloning it and pointing your Codex config at .codex-plugin/plugin.json.

For local development, keep Codex's installed skill copies synchronized from this repository:

node scripts/sync-codex-skills.mjs --dry-run
node scripts/sync-codex-skills.mjs

The repository's skills/ directory is the source of truth; ~/.codex/skills is a generated local install target.

Cursor

• In Cursor Agent chat, install from the marketplace:

  /add-plugin flowstate-skills
  

• Or search for "flowstate-skills" in the plugin marketplace.

If FlowState Skills is not yet listed, clone this repository and point Cursor at .cursor-plugin/plugin.json.

Gemini CLI

• Install the extension:

  gemini extensions install https://github.com/epic-digital-im/epic-flowstate-skills
  

• Update later:

  gemini extensions update flowstate-skills
  

OpenCode

OpenCode uses its own plugin install; install FlowState Skills separately even if you already use it in another harness.

• Tell OpenCode:

  Fetch and follow instructions from https://raw.githubusercontent.com/epic-digital-im/epic-flowstate-skills/main/.opencode/INSTALL.md
  

• Detailed docs: .opencode/INSTALL.md

GitHub Copilot CLI

• Register the marketplace:

  copilot plugin marketplace add epic-digital-im/epic-flowstate-skills
  

• Install the plugin:

  copilot plugin install flowstate-skills@epic-flowstate
  

Factory Droid

• Register the marketplace:

  droid plugin marketplace add https://github.com/epic-digital-im/epic-flowstate-skills
  

• Install the plugin:

  droid plugin install flowstate-skills@epic-flowstate
  

The Basic Workflow

1. flowstate-using-flowstate-skills — Loaded at session start. Establishes the absolute rules (never fabricate IDs, always read config) and the full skill catalog so every other skill is reachable by name.

2. flowstate-workspace-registration / flowstate-codebase-registration / flowstate-monorepo-audit — Activates when a repo is not yet linked to FlowState. Creates workspace, codebase, and per-package project records and writes .flowstate/config.json files.

3. flowstate-brainstorming — Activates before writing code. Refines rough ideas through Socratic discussion, presents the design in chunks for human approval, and saves an approved design spec document.

4. flowstate-multi-phase-planning — Activates with an approved design. Decomposes the spec into one milestone with N phase tasks, each scoping goals, deliverables, and acceptance criteria.

5. flowstate-executing-multi-phase-plan — Iterates phase tasks in sortOrder and runs the full task execution lifecycle for each.