Add workflows to cli!

Author: ericciarla

README.md

@@ -18,27 +18,30 @@ npx -y firecrawl-cli@1.16.2 init -y --browser
 - `--browser` opens the browser for Firecrawl authentication automatically
 - skills install globally to every detected AI coding agent by default
 
-### Setup Skills and MCP
+### Setup Skills, Workflows, and MCP
 
-If you are using an AI coding agent like Claude Code, you can also install the skills manually with:
+If you are using an AI coding agent like Claude Code, you can also install the skills manually:
 
 ```bash
 firecrawl setup skills
+firecrawl setup workflows
 ```
 
-This installs skills globally across all detected coding editors by default. Use `--agent <agent>` to scope it to one editor.
+These install globally across all detected coding editors by default. Use `--agent <agent>` to scope either command to one editor.
 
 ### Agent skills
 
-The init command installs both sets of Firecrawl agent skills into AI coding agents (Cursor, Claude Code, Windsurf, etc.):
+The init command installs all Firecrawl agent skill segments into AI coding agents (Cursor, Claude Code, Windsurf, etc.):
 
 - **CLI skills** — teach agents how to use the Firecrawl CLI for live web work (search, scrape, interact, map, crawl, agent)
 - **Build skills** — teach agents how to integrate Firecrawl into application code (choose endpoints, wire SDKs, set up API keys)
+- **Workflow skills** — teach agents how to produce Firecrawl-powered deliverables such as research briefs, SEO audits, QA reports, lead lists, knowledge bases, and design-system extraction
 
 To reinstall skills manually:
 
 ```bash
 firecrawl setup skills
+firecrawl setup workflows
 ```
 
 To install the Firecrawl MCP server into your editors (Cursor, Claude Code, VS Code, etc.):
@@ -700,42 +703,17 @@ firecrawl x download https://docs.firecrawl.dev --screenshot --limit 20 -y
 firecrawl x download https://docs.firecrawl.dev --include-paths "/features,/sdks" -y
 ```
 
-### AI Workflows
+### Workflow Skills
 
-Launch pre-built AI workflows that combine Firecrawl with your coding agent. One command spins up an interactive session with the right system prompt, tools, and instructions.
+The old experimental AI workflow commands have moved to the NPX-installable
+[`firecrawl/firecrawl-workflows`](https://github.com/firecrawl/firecrawl-workflows)
+skills package. Workflow skills infer from the user's request first and only ask
+short clarifying questions when required inputs are missing. Install them with:
 
 ```bash
-# Claude Code (available now)
-firecrawl x claude competitor-analysis https://firecrawl.dev
-firecrawl x claude deep-research "RAG pipeline data ingestion tools"
-firecrawl x claude lead-research "Vercel"
-firecrawl x claude seo-audit https://example.com
-firecrawl x claude qa https://myapp.com
-firecrawl x claude demo https://resend.com
-firecrawl x claude shop "best mechanical keyboard for developers"
-
-# Natural language (no workflow name)
-firecrawl x claude "scrape the firecrawl docs and summarize"
-
-# Codex and OpenCode -- coming soon
-firecrawl x codex competitor-analysis https://crawlee.dev
-firecrawl x opencode deep-research "browser automation frameworks"
+firecrawl setup workflows
 ```
 
-Add `-y` to auto-approve tool permissions.
-
-See the full documentation: **[Experimental Workflows ->](src/commands/experimental/README.md)**
-
-#### Prerequisites
-
-Each backend requires its CLI to be installed separately:
-
-| Backend  | Install                                               |
-| -------- | ----------------------------------------------------- |
-| Claude   | `npm install -g @anthropic-ai/claude-code`            |
-| Codex    | `npm install -g @openai/codex`                        |
-| OpenCode | [opencode.ai/docs/cli](https://opencode.ai/docs/cli/) |
-
 ---
 
 ## Documentation

package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl-cli",
-  "version": "1.17.0",
+  "version": "1.17.1",
   "description": "Command-line interface for Firecrawl. Scrape, crawl, and extract data from any website directly from your terminal.",
   "main": "dist/index.js",
   "bin": {

skills/firecrawl-cli/SKILL.md

@@ -13,7 +13,7 @@ Search, scrape, and interact with the web. Returns clean markdown optimized for
 
 Run `firecrawl --help` or `firecrawl <command> --help` for full option details.
 
-If the task is to integrate Firecrawl into an application, add `FIRECRAWL_API_KEY` to a project, or choose endpoint usage in product code, use the `firecrawl-build` skills. They are already installed alongside this CLI skill when you run `firecrawl init`.
+If the task is to integrate Firecrawl into an application, add `FIRECRAWL_API_KEY` to a project, or choose endpoint usage in product code, use the `firecrawl-build` skills. If the task is an outcome workflow such as deep research, SEO audit, QA, lead generation, knowledge-base creation, dashboard reporting, shopping research, or website design-system extraction, use the `firecrawl-workflows` skills. They are already installed alongside this CLI skill when you run `firecrawl init`.
 
 ## Prerequisites
 
@@ -90,6 +90,7 @@ For detailed command reference, run `firecrawl <command> --help`.
 - **Install, auth, or setup problems** -> [rules/install.md](rules/install.md)
 - **Output handling and safe file-reading patterns** -> [rules/security.md](rules/security.md)
 - **Integrating Firecrawl into an app, adding `FIRECRAWL_API_KEY` to `.env`, or choosing endpoint usage in product code** -> use the `firecrawl-build` skills (already installed alongside this CLI skill)
+- **Producing Firecrawl-powered deliverables such as research briefs, SEO audits, QA reports, lead lists, knowledge bases, or design-system extraction** -> use the `firecrawl-workflows` skills (already installed alongside this CLI skill). These skills infer from context first and ask only short blocking questions when needed.
 
 ## Output & Organization
 

skills/firecrawl-cli/rules/install.md

@@ -15,7 +15,7 @@ description: |
 npx -y firecrawl-cli@1.16.2 init -y --browser
 ```
 
-This installs `firecrawl-cli` globally, authenticates via browser, and installs all skills.
+This installs `firecrawl-cli` globally, authenticates via browser, and installs core, build, and workflow skills.
 
 This setup is safe to re-run when the CLI is missing, stale, or only partially configured.
 
@@ -31,6 +31,7 @@ To install skills manually:
 
 ```bash
 firecrawl setup skills
+firecrawl setup workflows
 ```
 
 ## Manual Install

src/__tests__/commands/init.test.ts

@@ -17,7 +17,7 @@ describe('handleInitCommand', () => {
     vi.restoreAllMocks();
   });
 
-  it('installs skills from both repos globally across all detected agents in non-interactive mode', async () => {
+  it('installs skills from all repos globally across all detected agents in non-interactive mode', async () => {
     await handleInitCommand({
       yes: true,
       skipInstall: true,
@@ -32,9 +32,13 @@ describe('handleInitCommand', () => {
       'npx -y skills add firecrawl/skills --full-depth --global --all --yes',
       expect.objectContaining({ stdio: ['ignore', 'pipe', 'pipe'] })
     );
+    expect(execSync).toHaveBeenCalledWith(
+      'npx -y skills add firecrawl/firecrawl-workflows --full-depth --global --all --yes',
+      expect.objectContaining({ stdio: ['ignore', 'pipe', 'pipe'] })
+    );
   });
 
-  it('scopes non-interactive skills install to one agent across both repos when provided', async () => {
+  it('scopes non-interactive skills install to one agent across all repos when provided', async () => {
     await handleInitCommand({
       yes: true,
       skipInstall: true,
@@ -50,5 +54,9 @@ describe('handleInitCommand', () => {
       'npx -y skills add firecrawl/skills --full-depth --global --yes --agent cursor',
       expect.objectContaining({ stdio: ['ignore', 'pipe', 'pipe'] })
     );
+    expect(execSync).toHaveBeenCalledWith(
+      'npx -y skills add firecrawl/firecrawl-workflows --full-depth --global --yes --agent cursor',
+      expect.objectContaining({ stdio: ['ignore', 'pipe', 'pipe'] })
+    );
   });
 });

src/__tests__/commands/setup.test.ts

@@ -15,7 +15,7 @@ describe('handleSetupCommand', () => {
     vi.restoreAllMocks();
   });
 
-  it('installs skills globally across all detected agents from both repos by default', async () => {
+  it('installs core and build skills globally across all detected agents by default', async () => {
     await handleSetupCommand('skills', {});
 
     expect(execSync).toHaveBeenCalledWith(
@@ -28,7 +28,7 @@ describe('handleSetupCommand', () => {
     );
   });
 
-  it('installs skills globally for a specific agent from both repos without using --all', async () => {
+  it('installs core and build skills globally for a specific agent without using --all', async () => {
     await handleSetupCommand('skills', { agent: 'cursor' });
 
     expect(execSync).toHaveBeenCalledWith(
@@ -41,6 +41,15 @@ describe('handleSetupCommand', () => {
     );
   });
 
+  it('installs workflow skills as a separate setup option', async () => {
+    await handleSetupCommand('workflows', {});
+
+    expect(execSync).toHaveBeenCalledWith(
+      'npx -y skills add firecrawl/firecrawl-workflows --full-depth --global --all',
+      expect.objectContaining({ stdio: 'inherit' })
+    );
+  });
+
   it('strips inherited npm_* env vars before nested npx calls', async () => {
     // Reproduces the bug where running this CLI under `npx -y firecrawl-cli@VERSION`
     // leaks npm_command/npm_lifecycle_event/npm_execpath into nested