diff --git a/skills/firecrawl-alexandria/SKILL.md b/skills/firecrawl-alexandria/SKILL.md index 6aff07bf67..e9ff3265fd 100644 --- a/skills/firecrawl-alexandria/SKILL.md +++ b/skills/firecrawl-alexandria/SKILL.md @@ -12,11 +12,11 @@ Alexandria brings ready-made website workflows, API providers, and specialized i Use ordinary web results when they answer the question; use a provider tool when its coverage and inputs fit. -## Send feedback after every Alexandria task +## Alexandria feedback -Alexandria coverage grows from what agents report. After you have finished the task (or decided the catalogue could not do it), send one `firecrawl alexandria feedback` per website you needed data from. It is free: no job ID, no time window, no credit refund. **Do this once per website**, in the background, after you finish processing the results, so it never blocks your main task. +Alexandria coverage grows from what agents report. If you choose to report how the catalogue served a task, send at most one `firecrawl alexandria feedback` per website you needed data from after finishing the task. It is free: no job ID, no time window, no credit refund. -Send it whether or not a tool ran: +Feedback can describe any of these outcomes: - A tool answered the need, fully or partly. - A tool ran but returned wrong or incomplete data, or failed. @@ -34,7 +34,7 @@ Send it whether or not a tool ran: - **`--silent &`** is the right pattern: exit code 0 even on failure, so a rejected call never crashes your pipeline. ```bash -# Send once per website you needed data from, after the task is done. Replace the +# Example: send at most once per website after the task is done. Replace the # placeholders with what actually happened; drop --provider-feedback or # --capability-feedback when there is nothing to report at that level. firecrawl alexandria feedback \ @@ -46,6 +46,6 @@ firecrawl alexandria feedback \ --silent & ``` -When no provider covered the site at all, report the gap with `--provider-feedback '[{"name":"","issue":"missing_provider","why":""}]'` and rate `bad`; that is the signal we use to onboard new providers. +If you report a site with no provider coverage, use `--provider-feedback '[{"name":"","issue":"missing_provider","why":""}]'` and rate `bad`; that is the signal we use to onboard new providers. `--silent` suppresses output and `&` runs it in the background so feedback never blocks you. Run `firecrawl alexandria feedback --help` for every option. diff --git a/skills/firecrawl-search/SKILL.md b/skills/firecrawl-search/SKILL.md index 3cae0bf9b1..578badaa97 100644 --- a/skills/firecrawl-search/SKILL.md +++ b/skills/firecrawl-search/SKILL.md @@ -53,7 +53,7 @@ Use `list` for category/provider browsing and selected contracts. For a known we If no returned tool covers the country/market/segment or required inputs, continue with ordinary web results. Do not exhaust the catalogue or pay for adjacent tools just to probe coverage. `--sources web` explicitly opts out of Alexandria; `--sources web --domain-tools` retains domain matches only. -Whenever you looked for or ran an Alexandria tool, send `firecrawl alexandria feedback` once you are done, including when nothing covered the site. It is free and runs in the background; the pattern and rules live in [firecrawl-alexandria](../firecrawl-alexandria/SKILL.md). +For Alexandria feedback about a provider result or coverage gap, see [firecrawl-alexandria](../firecrawl-alexandria/SKILL.md). ## Progressive discovery and output handling diff --git a/skills/firecrawl/SKILL.md b/skills/firecrawl/SKILL.md index 290bffbdf0..67c83d0e4b 100644 --- a/skills/firecrawl/SKILL.md +++ b/skills/firecrawl/SKILL.md @@ -117,7 +117,7 @@ Single format outputs raw content. Multiple formats (e.g., `--format markdown,li After using search results, send `firecrawl search-feedback` (the first feedback per search refunds 1 credit). The full pattern, guard, and rules live in [firecrawl-search](../firecrawl-search/SKILL.md). -After an Alexandria task (a tool ran, or you looked for one and nothing covered the site), send `firecrawl alexandria feedback` once per website you needed data from. It is free and has no job ID; the pattern and issue codes live in [firecrawl-alexandria](../firecrawl-alexandria/SKILL.md). +For Alexandria feedback about a provider result or coverage gap, see [firecrawl-alexandria](../firecrawl-alexandria/SKILL.md). For non-search endpoint jobs, use `firecrawl feedback ` to send concise job-level feedback through `/v2/feedback`. Supported endpoints are `search`, `scrape`, `parse`, and `map`.