docs-search

Searches aem.live documentation and blog posts by keyword with relevance scoring.

1|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aemgdc/aemdev --skill docs-search-aemgdc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: docs-search
Source: https://github.com/aemgdc/aemdev/tree/main/.agents/skills/docs-search
Command: npx skills add https://github.com/aemgdc/aemdev --skill docs-search-aemgdc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Finding the right AEM Edge Delivery Services documentation page is slow when general web searches return irrelevant results. This Skill searches the complete aem.live documentation index directly and returns ranked, relevant pages. ## Core Features & Use Cases - Keyword Search with Relevance Scoring: Searches 150+ documentation pages (and blog posts when needed) using weighted title, description, and content matching. - Deprecation Detection: Flags deprecated features in results so you can warn users and suggest current alternatives. - Structured JSON Output: Returns path, title, description, snippet, type, and relevance score for each result. - Use Case: When asked "How do I decorate blocks in aem.live?", run the search script with keywords like "block decoration", review the top results, then fetch the full page at https://www.aem.live{path} to give a complete answer. ## Quick Start Ask the assistant to search the aem.live documentation for a specific feature such as "metadata" or "universal editor" and summarize the most relevant pages.

Frequently Asked Questions about docs-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search aem.live documentation from the command line?▼

Run node .claude/skills/docs-search/scripts/search.js followed by one to three keywords, such as "block decoration". Add the --all flag to return every match instead of the default top 10 results.

What does the docs-search script return for each result?▼

Each result is a JSON object with path, title, description, snippet, type (doc or blog), deprecation notice, and a relevanceScore. Results are sorted by score, highest first.

Does the search include aem.live blog posts?▼

Blog posts are searched only when fewer than five documentation results match your keywords. Use the --all flag for broader coverage across both docs and blog content.

Why are some keywords ignored by the search script?▼

The script filters stop words like "the", "aem", "edge", and "services" because they match too many pages. Use specific terms like "metadata" or "sidekick plugin" for useful results.

How are deprecated features handled in search results?▼

Deprecated pages receive a 50 percent relevance score penalty but still appear in results with a deprecation message. You should alert the user and point them to higher-ranked non-deprecated alternatives.