docs(skills): make Alexandria feedback optional

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":"<site or provider>","issue":"missing_provider","why":"<what was needed>"}]'` 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":"<site or provider>","issue":"missing_provider","why":"<what was needed>"}]'` 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.

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
 

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 <endpoint> <jobId>` to send concise job-level feedback through `/v2/feedback`. Supported endpoints are `search`, `scrape`, `parse`, and `map`.