Bundled CLI skills are out of sync with firecrawl-cli 1.19.27
- 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