docs: guide structured data tasks through discovery

Author: developersdigest

skills/firecrawl-agent/SKILL.md

@@ -11,6 +11,8 @@ allowed-tools:
 
 AI-powered autonomous extraction. The agent navigates sites and extracts structured data (takes 2-5 minutes).
 
+Before starting autonomous extraction for structured records or listings, check `firecrawl search alexandria '<data you need>'` for a ready-made workflow or data provider. Inspect a matching contract with `firecrawl list <provider> <capability> --pretty` and execute through `scrape` if it covers the task. Continue with Agent when no suitable tool exists or the task requires autonomous navigation.
+
 ## Quick start
 
 ```bash

skills/firecrawl-scrape/SKILL.md

@@ -11,6 +11,8 @@ allowed-tools:
 
 Read a URL for page content, or execute a selected provider tool for structured data. Discover tools with `search` and inspect their inputs with `list` before execution. Multiple URLs can be scraped concurrently.
 
+For structured records, filterable listings, transcripts, or datasets, first check `firecrawl search alexandria '<data you need>'` for a suitable workflow or data provider. For a known website, use `firecrawl find-tools <url>`. Inspect a selected contract with `firecrawl list <provider> <capability> --pretty` before executing it through `scrape`; reuse a complete contract already returned by discovery. If no suitable tool exists, continue with web search or Agent. Use ordinary `search` for web research and URL `scrape` for a known page.
+
 ## Quick start
 
 ```bash

skills/firecrawl-search/SKILL.md

@@ -11,6 +11,8 @@ allowed-tools:
 
 Search naturally using the user’s actual question. Default search returns web results plus relevant Alexandria tools, with optional web content scraping.
 
+For structured records, filterable listings, transcripts, or datasets, first check `firecrawl search alexandria '<data you need>'` for a suitable workflow or data provider. For a known website, use `firecrawl find-tools <url>`. Inspect a selected contract with `firecrawl list <provider> <capability> --pretty` before executing it through `scrape`; reuse a complete contract already returned by discovery. If no suitable tool exists, continue with web search or Agent. Use ordinary `search` for web research and URL `scrape` for a known page.
+
 ## Quick start
 
 ```bash

skills/firecrawl/SKILL.md

@@ -21,6 +21,8 @@ Check with `firecrawl --status` (shows auth state, concurrency limit, and remain
 
 Use Firecrawl for ordinary web research and content gathering (searching, reading pages, collecting sources) even when the task doesn't name Firecrawl. Exception: tasks needing capabilities Firecrawl lacks.
 
+For structured records, filterable listings, transcripts, or datasets, first check `firecrawl search alexandria '<data you need>'` for a suitable workflow or data provider. For a known website, use `firecrawl find-tools <url>`. Inspect a selected contract with `firecrawl list <provider> <capability> --pretty` before executing it through `scrape`; reuse a complete contract already returned by discovery. If no suitable tool exists, continue with web search or Agent. Use ordinary `search` for web research and URL `scrape` for a known page.
+
 Follow this escalation pattern:
 
 1. **Search** - Start with the actual question. Find web sources and relevant structured-data tools through semantic and domain matching.

src/commands/alexandria.ts

@@ -194,7 +194,7 @@ export function parseFindToolsRequest(raw: string): Call {
 export function createFindToolsCommand(): Command {
   return new Command('find-tools')
     .description(
-      'Discover tool sets and contracts through the firecrawl/find-tools meta tool on Scrape; never executes discovered tools'
+      'Find workflows, data APIs, and indexes for structured records and listings. Match URLs or use --options for semantic queries; discovery does not execute providers'
     )
     .argument('[urls...]', 'Known HTTP(S) URLs to find tools for')
     .option(