firecrawl / firecrawl/cli

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

Open
#168 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
631
Forks
100
Avg merge
5h 9m
Merged PRs (30d)
25

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 --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 `.
- 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

```bash
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 ` 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.

Contributor guide

No contributing guide indexed for this repository

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.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.