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

Open
#168 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
72/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Quiet
Tech stack
markdown, typescript
Domain
cli, documentation

Research direction

Start with the affected SKILL.md files under skills/, then run the listed firecrawl help commands and compare them with src/index.ts and the current monitoring documentation. Update the command examples, flags, formats, version guidance, and limits so they match the published CLI, and validate each affected skill against the command help output.

Written by the indexing model from the issue text.

Description

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.

Dominant language
TypeScript
Stars
635
Forks
106
Avg merge
1h 33m
Merged PRs (30d)
43

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from firecrawl/cli

All issues in firecrawl/cli

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.