Skip to content

Bundled CLI skills are out of sync with firecrawl-cli 1.19.27 #168

Description

@igorgarbuz

Summary

Several bundled skill files under skills/ document commands, options, or supported values that do not match the currently published firecrawl-cli 1.19.27 command surface. This can cause installed skills to invoke invalid commands or give incorrect guidance.

Environment

  • Installed CLI: firecrawl-cli 1.19.27
  • Repository main: 1c91d7cbbc20df7b01c57f7a3132957e9b50af4c
  • Comparison source: firecrawl <command> --help, the corresponding command registration in src/index.ts, and the current Firecrawl monitoring documentation

Verified mismatches

  1. skills/firecrawl-interact/SKILL.md

    • Uses --language bash and documents --language <lang>.
    • CLI 1.19.27 instead exposes --bash, --python, and --node.
  2. skills/firecrawl-scrape/SKILL.md

    • Describes -H as including HTTP headers.
    • CLI 1.19.27 defines -H, --html as raw HTML output, equivalent to --format html.
  3. skills/firecrawl-download/SKILL.md

    • Every example uses the removed top-level form firecrawl download.
    • CLI 1.19.27 exposes download under firecrawl experimental download and its alias firecrawl x download.
    • The statement that all scrape options work with download is broader than the options actually registered by the download command.
  4. skills/firecrawl-parse/SKILL.md

    • Advertises .xhtml support.
    • CLI 1.19.27 accepts .html and .htm, but not .xhtml.
    • Its format table also omits several formats exposed by firecrawl parse --help.
  5. skills/firecrawl-monitor/SKILL.md

    • States that the minimum schedule interval is 15 minutes.
    • Current Firecrawl monitoring documentation states a 5-minute minimum, which already matches the umbrella CLI skill.
  6. skills/firecrawl-search/SKILL.md

    • Omits the --highlights and --no-highlights options added in CLI 1.19.27 and documented in the repository README.
  7. skills/firecrawl-cli/SKILL.md and its rule files

    • The example status output still shows CLI 1.8.0.
    • The workflow table refers to the invalid top-level download command.
    • Installation guidance still pins firecrawl-cli@1.19.6, while the repository package version and published CLI are 1.19.27.

Reproduction

firecrawl --version
firecrawl interact --help
firecrawl scrape --help
firecrawl experimental download --help
firecrawl parse --help
firecrawl monitor create --help
firecrawl search --help

Compare those outputs with the option tables and examples in the affected skill files.

Expected behavior

Bundled CLI skills should only recommend command forms, flags, formats, extensions, and limits supported by the current published CLI and Firecrawl documentation.

Proposed correction

  • Replace --language <lang> with --bash, --python, and --node.
  • Correct the meaning of -H.
  • Change download examples to firecrawl x download or firecrawl experimental download and describe only its registered options.
  • Remove .xhtml and align the parse format list.
  • Change the monitor minimum interval to 5 minutes.
  • Add the new search highlight options.
  • Update or make version examples and installation commands version-neutral so they do not immediately drift again.

A documentation-only PR can address these together and validate the result against the CLI help output.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions