From 942049e2d54e8f038dbb39e15aa969b0fb64a1fe Mon Sep 17 00:00:00 2001 From: Max Loffgren Date: Thu, 24 Sep 2026 12:26:34 -0500 Subject: [PATCH 1/4] docs(skills): make Alexandria feedback optional --- skills/firecrawl-alexandria/SKILL.md | 10 +++++----- skills/firecrawl-search/SKILL.md | 2 +- skills/firecrawl/SKILL.md | 2 +- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/skills/firecrawl-alexandria/SKILL.md b/skills/firecrawl-alexandria/SKILL.md index 6aff07bf67..8ccd51a67a 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 +## Optional 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 quality feedback is optional. 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 +# Optional: 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..54f8c4eb4f 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). +Optional Alexandria quality feedback is free and can describe a provider result or a coverage gap. The pattern and rules live in [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..cd10b743ac 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). +Optional Alexandria quality feedback can describe a provider result or a coverage gap. It is free and has no job ID; the pattern and issue codes live in [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`. From ee54a3567da7aa23bb6193e1ff999e98a5fd9062 Mon Sep 17 00:00:00 2001 From: Max Loffgren Date: Thu, 24 Sep 2026 12:38:12 -0500 Subject: [PATCH 2/4] docs(skills): streamline Alexandria feedback guidance --- skills/firecrawl-alexandria/SKILL.md | 6 +++--- skills/firecrawl-search/SKILL.md | 2 +- skills/firecrawl/SKILL.md | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/skills/firecrawl-alexandria/SKILL.md b/skills/firecrawl-alexandria/SKILL.md index 8ccd51a67a..3e738a22f1 100644 --- a/skills/firecrawl-alexandria/SKILL.md +++ b/skills/firecrawl-alexandria/SKILL.md @@ -12,9 +12,9 @@ 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. -## Optional Alexandria feedback +## Alexandria feedback -Alexandria quality feedback is optional. 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. +Alexandria quality feedback is optional. When reporting 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. Feedback can describe any of these outcomes: @@ -34,7 +34,7 @@ Feedback can describe any of these outcomes: - **`--silent &`** is the right pattern: exit code 0 even on failure, so a rejected call never crashes your pipeline. ```bash -# Optional: send at most once per website 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 \ diff --git a/skills/firecrawl-search/SKILL.md b/skills/firecrawl-search/SKILL.md index 54f8c4eb4f..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. -Optional Alexandria quality feedback is free and can describe a provider result or a coverage gap. 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 cd10b743ac..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). -Optional Alexandria quality feedback can describe a provider result or a coverage gap. 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`. From 3a6f5f68e007152d1e14ad4220b5b8dfb60dfb5c Mon Sep 17 00:00:00 2001 From: Max Loffgren Date: Thu, 24 Sep 2026 22:56:05 -0500 Subject: [PATCH 3/4] docs(skills): explain Alexandria feedback value --- skills/firecrawl-alexandria/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/firecrawl-alexandria/SKILL.md b/skills/firecrawl-alexandria/SKILL.md index 3e738a22f1..06edee70bf 100644 --- a/skills/firecrawl-alexandria/SKILL.md +++ b/skills/firecrawl-alexandria/SKILL.md @@ -14,7 +14,7 @@ Use ordinary web results when they answer the question; use a provider tool when ## Alexandria feedback -Alexandria quality feedback is optional. When reporting 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. +Alexandria coverage grows from what agents report. When reporting 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. Feedback can describe any of these outcomes: From 4c9411792096d60a66c8d640a3f21b980a128d42 Mon Sep 17 00:00:00 2001 From: Max Loffgren Date: Thu, 24 Sep 2026 22:59:39 -0500 Subject: [PATCH 4/4] docs(skills): clarify voluntary Alexandria feedback --- skills/firecrawl-alexandria/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/firecrawl-alexandria/SKILL.md b/skills/firecrawl-alexandria/SKILL.md index 06edee70bf..e9ff3265fd 100644 --- a/skills/firecrawl-alexandria/SKILL.md +++ b/skills/firecrawl-alexandria/SKILL.md @@ -14,7 +14,7 @@ Use ordinary web results when they answer the question; use a provider tool when ## Alexandria feedback -Alexandria coverage grows from what agents report. When reporting 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. +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. Feedback can describe any of these outcomes: