docs: improve skill description for better trigger accuracy

skills/firecrawl-cli/SKILL.md

@@ -1,7 +1,10 @@
 ---
 name: firecrawl
-description: |
-  Search, scrape, and interact with the web via the Firecrawl CLI. Use this skill whenever the user wants to search the web, find articles, research a topic, look something up online, scrape a webpage, grab content from a URL, get data from a website, crawl documentation, download a site, or interact with pages that need clicks or logins. Also use when they say "fetch this page", "pull the content from", "get the page at https://", or reference external websites. This provides real-time web search with full page content and interact capabilities — beyond what Claude can do natively with built-in tools. Do NOT trigger for local file operations, git commands, deployments, or code editing tasks.
+description: >-
+  This skill should be used when the user asks to "search the web", "scrape this page", "fetch
+  this page", "pull the content from", "get the page at https://", "crawl documentation",
+  "download a site", or wants to search, scrape, and interact with web pages via Firecrawl CLI
+  — providing real-time web search with full page content beyond built-in tools.
 allowed-tools:
   - Bash(firecrawl *)
   - Bash(npx firecrawl *)

skills/firecrawl-crawl/SKILL.md

@@ -1,7 +1,10 @@
 ---
 name: firecrawl-crawl
-description: |
-  Bulk extract content from an entire website or site section. Use this skill when the user wants to crawl a site, extract all pages from a docs section, bulk-scrape multiple pages following links, or says "crawl", "get all the pages", "extract everything under /docs", "bulk extract", or needs content from many pages on the same site. Handles depth limits, path filtering, and concurrent extraction.
+description: >-
+  This skill should be used when the user asks to "crawl this site", "get all the pages",
+  "extract everything under /docs", "bulk extract", "crawl documentation", or wants to
+  bulk-extract content from an entire website or site section with depth limits and path
+  filtering.
 allowed-tools:
   - Bash(firecrawl *)
   - Bash(npx firecrawl *)

skills/firecrawl-map/SKILL.md

@@ -1,7 +1,9 @@
 ---
 name: firecrawl-map
-description: |
-  Discover and list all URLs on a website, with optional search filtering. Use this skill when the user wants to find a specific page on a large site, list all URLs, see the site structure, find where something is on a domain, or says "map the site", "find the URL for", "what pages are on", or "list all pages". Essential when the user knows which site but not which exact page.
+description: >-
+  This skill should be used when the user asks to "map the site", "find the URL for", "what
+  pages are on", "list all pages", or wants to discover and list all URLs on a website — useful
+  when the user knows the domain but not the exact page location.
 allowed-tools:
   - Bash(firecrawl *)
   - Bash(npx firecrawl *)

skills/firecrawl-scrape/SKILL.md

@@ -1,7 +1,10 @@
 ---
 name: firecrawl-scrape
-description: |
-  Extract clean markdown from any URL, including JavaScript-rendered SPAs. Use this skill whenever the user provides a URL and wants its content, says "scrape", "grab", "fetch", "pull", "get the page", "extract from this URL", or "read this webpage". Handles JS-rendered pages, multiple concurrent URLs, and returns LLM-optimized markdown. Use this instead of WebFetch for any webpage content extraction.
+description: >-
+  This skill should be used when the user provides a URL and says "scrape", "grab", "fetch",
+  "pull", "get the page", "extract from this URL", "read this webpage", or wants clean markdown
+  content from any URL (including JS-rendered SPAs). Use this instead of WebFetch for webpage
+  content extraction.
 allowed-tools:
   - Bash(firecrawl *)
   - Bash(npx firecrawl *)

skills/firecrawl-search/SKILL.md

@@ -1,7 +1,9 @@
 ---
 name: firecrawl-search
-description: |
-  Web search with full page content extraction. Use this skill whenever the user asks to search the web, find articles, research a topic, look something up, find recent news, discover sources, or says "search for", "find me", "look up", "what are people saying about", or "find articles about". Returns real search results with optional full-page markdown — not just snippets. Provides capabilities beyond Claude's built-in WebSearch.
+description: >-
+  This skill should be used when the user asks to "search for", "find me", "look up", "what are
+  people saying about", "find articles about", "search the web for", or wants web search
+  results with full page content extraction (not just snippets) via Firecrawl.
 allowed-tools:
   - Bash(firecrawl *)
   - Bash(npx firecrawl *)