.claude/skills/mcp-search/SKILL.md
Search, analyze, and author Elastic documentation using the remote MCP server. Use this when the user asks about Elastic product documentation, features, or APIs; wants to find, read, or verify existing docs pages; is writing or editing documentation; mentions cross-links between repos; asks about documentation structure, coherence, or consistency; wants to generate templates following Elastic content type guidelines; or references elastic.co/docs URLs or Elastic product names.
npx skillsauth add elastic/docs-builder mcp-searchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
This skill provides access to Elastic documentation through a remote MCP server. Use these tools to search, analyze, author, and validate documentation content.
When to use: User asks about Elastic product features, needs to find existing docs pages, verify published content, or research what documentation exists on a topic.
Trigger words: search, find, docs, documentation, look up, examples, query, what docs, Elastic features
Parameters:
query (required): The search query — can be a question or keywordspageNumber (optional, default: 1): Page number (1-based)pageSize (optional, default: 10, max: 50): Number of results per pageproductFilter (optional): Filter by product ID (e.g., 'elasticsearch', 'kibana', 'fleet', 'logstash')sectionFilter (optional): Filter by navigation section (e.g., 'reference', 'getting-started')Returns: Search results with URLs, titles, descriptions, AI summaries, scores, and navigation context.
When to use: User wants to explore what documentation exists around a subject, build context for writing, or discover related content they should be aware of.
Trigger words: related, similar, links, content reuse, related documentation, see also, what else
Parameters:
topic (required): Topic or search terms to find related documents forlimit (optional, default: 10, max: 20): Maximum number of related documents to returnproductFilter (optional): Filter by product IDReturns: List of related documents with URLs, titles, descriptions, AI summaries, and relevance scores.
When to use: User wants to review documentation quality, audit coverage of a feature or concept, or check whether a topic is documented consistently across products and sections.
Trigger words: verify, check, accurate, coherent, validate, consistency, coverage, align with docs, audit
Parameters:
topic (required): Topic or concept to check coherence forlimit (optional, default: 20, max: 50): Maximum number of documents to analyzeReturns: Coherence analysis including:
When to use: User wants to audit docs quality, verify that instructions don't contradict each other, or check for overlapping content within a product area.
Trigger words: inconsistencies, contradictions, conflicts, discrepancies, compare, differences, overlaps
Parameters:
topic (required): Topic or concept to check for inconsistenciesfocusArea (optional): Specific area to focus on (e.g., 'installation', 'configuration', 'api')Returns: Analysis of potential inconsistencies including:
When to use: User provides an elastic.co/docs URL, references a known page, or you need the full content and metadata of a specific doc.
Trigger words: get document, fetch, URL, specific page, retrieve, show page, elastic.co
Parameters:
url (required): The document URL. Accepts a full URL (e.g., https://www.elastic.co/docs/deploy-manage/api-keys) or a path (e.g., /docs/deploy-manage/api-keys). Query strings, fragments, and trailing slashes are ignored.includeBody (optional, default: false): Include full body content (set true for detailed analysis)Returns: Full document content including:
When to use: User wants to evaluate page quality, check heading hierarchy, or assess AI enrichment status.
Trigger words: structure, hierarchy, organization, headings, parents, layout, analyze, quality
Parameters:
url (required): The document URL to analyze. Accepts a full URL (e.g., https://www.elastic.co/docs/deploy-manage/api-keys) or a path (e.g., /docs/deploy-manage/api-keys). Query strings, fragments, and trailing slashes are ignored.Returns: Structure analysis including:
When to use: User references a cross-link, needs to verify a link target, or wants to know what anchors are available on a page.
Trigger words: cross-link, resolve, cross link, docs-content://, URI, anchor
Parameters:
crossLink (required): The cross-link URI to resolve (e.g., docs-content://get-started/intro.md)Returns: Resolved URL, repository, path, available anchors, and any fragment.
When to use: User needs to know which repositories publish documentation or wants to explore the docs ecosystem.
Trigger words: list repos, repositories, available repos, cross-link index, docs ecosystem
Parameters: None
Returns: List of repositories with names, branches, paths, git refs, and last-updated timestamps.
When to use: User wants to explore what a repository publishes, build a cross-link, or look up available anchor targets.
Trigger words: repository links, pages in repo, anchors, what does repo publish
Parameters:
repository (required): The repository name (e.g., docs-content, elasticsearch)Returns: Repository metadata, URL path prefix, page count, cross-link count, and a list of pages with their anchors.
When to use: User wants to analyze inter-repository dependencies, check what links into or out of a repository, or audit cross-link usage.
Trigger words: find cross-links, links between repos, who links to, links from, dependencies
Parameters:
from (optional): Source repository to find links fromto (optional): Target repository to find links toReturns: Count and list of cross-links with source repository, target repository, and the link URI.
When to use: User wants to check link health, prepare a release, or diagnose broken cross-references.
Trigger words: validate cross-links, broken links, check links, link validation, link health
Parameters:
repository (required): Target repository to validate links to (e.g., docs-content)Returns: Valid link count, broken link count, and details of any broken links (source repo, link URI, errors).
When to use: User is deciding what type of page to create or asks about Elastic docs structure.
Trigger words: content types, what type, overview vs how-to, tutorial, troubleshooting, changelog type
Parameters: None
Returns: List of all content types (overview, how-to, tutorial, troubleshooting, changelog) with descriptions and when-to-use guidance.
When to use: User wants to create a new documentation page, needs a starting point with correct frontmatter and structure, or asks for a template.
Trigger words: template, generate, starter, scaffold, new page, new doc
Parameters:
contentType (required): One of overview, how-to, tutorial, troubleshooting, or changelogtitle (optional): Pre-fill the page or changelog titledescription (optional): Pre-fill the frontmatter descriptionproduct (optional): Pre-fill the product fieldReturns: A ready-to-use Markdown template (or YAML for changelogs) with correct frontmatter and structure.
When to use: User is writing new content, reviewing existing pages against standards, or asks about Elastic docs best practices.
Trigger words: guidelines, best practices, how to write, checklist, evaluate, anti-patterns
Parameters:
contentType (required): One of overview, how-to, tutorial, troubleshooting, or changelogReturns: Detailed guidelines including required elements checklist, recommended sections, best practices, and anti-patterns for the content type.
SemanticSearch to find relevant documentation. Prefer this over a general web search for Elastic docs content.CheckCoherence to see how well a topic is documented.FindInconsistencies to identify potential documentation conflicts.GetDocumentByUrl when you have an exact URL.AnalyzeDocumentStructure to understand page organization.ResolveCrossLink to turn a cross-link URI into a real URL, ListRepositories to discover available repos, and ValidateCrossLinks to find broken links.ListContentTypes to pick the right type, GenerateTemplate to get a starter, and GetContentTypeGuidelines to write or evaluate content correctly.Common product filters:
elasticsearch - Elasticsearchkibana - Kibanafleet - Fleet and Elastic Agentlogstash - Logstashbeats - Beatscloud - Elastic Cloudecs - Elastic Common Schemaapm - APMsecurity - Elastic Securityobservability - Elastic Observabilitytools
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.