Przejdź do treści
Biblioteka skilli
Programowanie · Research

docs-search

/docs-search

Przeszukuje dokumentację aem.live o funkcjach AEM Edge Delivery Services, szereguje strony według trafności, pobiera pełne artykuły i wskazuje przykłady kodu oraz ostrzeżenia o wycofywaniu.

Repozytorium
skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
24.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
7
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 24.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/search.js

Co robi i kiedy

Przeszukuje dokumentację aem.live o funkcjach AEM Edge Delivery Services, szereguje strony według trafności, pobiera pełne artykuły i wskazuje przykłady kodu oraz ostrzeżenia o wycofywaniu.

Oryginalny opis (EN)

Use this when you need more information about an AEM Edge Delivery Services (EDS, Franklin, Helix) feature or guidance on how to implement one, and your existing web-search tools are not turning up relevant results. Searches the aem.live documentation, ranks matching pages by relevance, fetches full articles, and surfaces code examples and deprecation warnings.

Jak działa

  1. Overview
  2. When to Use This Skill
  3. How to Use This Skill
  4. What Gets Searched
  5. Examples
  6. Related Skills
  7. Important Reminders
Sekcje z nagłówków SKILL.md, w oryginale · 193 linii, 986 słów
Podgląd SKILL.md
---
name: docs-search
description: "Use this when you need more information about an AEM Edge Delivery Services (EDS, Franklin, Helix) feature or guidance on how to implement one, and your existing web-search tools are not turning up relevant results. Searches the aem.live documentation, ranks matching pages by relevance, fetches full articles, and surfaces code examples and deprecation warnings."
license: Apache-2.0
metadata:
  version: "1.0.1"
---

# Searching AEM Documentation

## Overview

This skill helps you efficiently search the complete aem.live documentation (docs and blog posts) without wasting context on irrelevant pages. Use the provided search script to find relevant documentation pages, then fetch and read the full content of the most relevant results.

## When to Use This Skill

Use this skill when:
- You need information about an aem.live feature or concept
- You've already looked at the project codebase for context
- You've tried a basic web search but didn't find relevant aem.live documentation
- You need technical guidance on implementing aem.live features
- You're looking for best practices or examples from the official docs

**Do NOT use this skill when:**
- You need reusable code snippets or block examples (use `block-collection-and-party` instead)
- You already know the specific documentation URL
- You're looking for general web development information (not aem.live specific)

## How to Use This Skill

### Step 1: Identify Keywords

Determine 1-3 specific keywords related to what you're searching for. Be specific rather than general.

**Good keywords:**
- "block decoration"
- "metadata"
- "universal editor"
- "sidekick plugin"

**Poor keywords:**
- "aem" (too generic, filtered as stop word)
- "how to build website" (too broad)
- "the" (stop word)

### Step 2: Run the Search Script

Execute the search script from the project root:

```bash
node .claude/skills/docs-search/scripts/search.js [--all] <keyword1> [keyword2] [...]
```

**Options:**
- `--all`: Return all matching results (default: limit to 10 most relevant)
- Without `--all`: Returns top 10 results

**Examples:**
```bash
# Search for block decoration info
node .claude/skills/docs-search/scripts/search.js block decoration

# Search for metadata with all results
node .claude/skills/docs-search/scripts/search.js --all metadata

# Multi-word search
node .claude/skills/docs-search/scripts/search.js universal editor blocks
```

### Step 3: Review Search Results

The script returns JSON with the following structure:

```json
[
  {
    "path": "/developer/markup-sections-blocks",
    "title": "Markup, Sections, Blocks, and Auto Blocking",
    "description": "To design websites and create functionality, developers use the markup and DOM...",
    "snippet": "Markup, Sections, Blocks, and Auto Blocking\n\nTo design websites...",
    "type": "doc",
    "deprecation": null,
    "relevanceScore": 141
  }
]
```

**Field Explanations:**
- `path`: URL path to the documentation page
- `title`: Page title
- `description`: Brief summary (usually ~150 chars) - **use this for quick context**
- `snippet`: Relevant excerpt from the page content showing keyword context
- `type`: "doc" or "blog"
- `deprecation`: Warning message if feature is deprecated (or null)
- `relevanceScore`: Relevance score (higher = more relevant)

**Important Notes:**
- Results are sorted by relevance (highest first)
- Deprecated pages have reduced relevance scores but still appear in results
- The `description` field provides the best quick summary of the page
- The `snippet` shows keyword context but may not be comprehensive

### Step 4: Fetch and Read Full Documentation

The search results give you an overview. To get detailed information, you must fetch and read the complete page content.

**Target URL format:**
```
https://www.aem.live{path}
```

**How to retrieve:** Use whatever method you have available to fetch the full HTML/text content:
- Dedicated web fetching tools
- Terminal commands (curl, wget, etc.)
- Web browsing/scraping capabilities

**Best Practice:** Start with the top 2-3 most relevant results, read them fully, then decide if you need more. You may also follow links referenced in the documentation or conduct additional searches based on what you learn.

### Step 5: Alert User to Deprecations

If any results have a `deprecation` field with content, **inform the user** that the feature is deprecated and include the deprecation message. Suggest they look at higher-ranked (non-deprecated) alternatives.

## What Gets Searched

The search script searches documentation first (150+ pages). Blog posts are only searched if fewer than 5 doc results are found. If you need comprehensive coverage including blogs, use the `--all` flag.

## Examples

### Example 1: Finding Block Documentation

**User Request:** "How do I decorate blocks in aem.live?"

**Good Approach:**
1. Search: `node .claude/skills/docs-search/scripts/search.js block decoration`
2. Review top 3 results
3. Fetch the most relevant: `https://www.aem.live/developer/markup-sections-blocks`
4. Read full content and provide answer

**Poor Approach:**
- Using general web search instead (wastes time on irrelevant results)
- Not using the search script (might miss the best documentation page)

### Example 2: Learning About Metadata

**User Request:** "I need to add metadata to my pages"

**Good Approach:**
1. Search: `node .claude/skills/docs-search/scripts/search.js metadata`
2. Notice top result is "/docs/bulk-metadata" (score: 63)
3. Also see "/docs/metadata" (score: 30)
4. Fetch and read both to understand page-level vs bulk metadata
5. Provide comprehensive answer with both approaches

**Poor Approach:**
- Only reading the first result and missing bulk metadata option
- Not using `--all` when you need comprehensive coverage

### Example 3: Deprecated Feature Warning

**User Request:** "How do I use folder mapping?"

**Search Results:**
```json
[
  {
    "path": "/developer/authoring-path-mapping",
    "title": "Path mapping for AEM authoring",
    "relevanceScore": 51,
    "deprecation": null
  },
  {
    "path": "/developer/folder-mapping",
    "title": "Folder Mapping",
    "relevanceScore": 34.5,
    "deprecation": "Please contact us if you have a use case for folder mapping..."
  }
]
```

**Good Response:**
"I found information about folder mapping, but **this feature is deprecated**. The deprecation notice says: 'Please contact us if you have a use case for folder mapping...'. The current recommended approach is **Path mapping for AEM authoring** (the top result). Let me read that documentation for you instead."

**Poor Response:**
- Ignoring the deprecation warning and implementing the deprecated feature
- Not mentioning the better alternative

## Related Skills

- **block-collection-and-party**: Use when you need reusable code examples or block implementations
- **building-blocks**: Use when creating new blocks from scratch
- **content-modeling**: Use when designing content models for blocks

## Important Reminders

1. **Always check for deprecation warnings** and alert the user
2. **Fetch and read full pages** - search results are just for finding the right pages
3. **Start with top 2-3 results** before expanding search
4. **The description field is your friend** - it's usually well-written and concise
5. **Don't rely solely on snippets** - they're for context, not comprehensive information
Pliki w paczce (7)
  • .releaserc.json 1 KB
  • CHANGELOG.md 1 KB
  • SKILL.md 7 KB
  • package.json 1 KB
  • scripts/package-lock.json 1 KB
  • scripts/package.json 1 KB
  • scripts/search.js 10 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · adobe/skills100Apache-2.0
23blocks-OS/ai-maestro-plugins100MIT
pproenca/dot-skills100MIT
davila7/claude-code-templates95MIT
doloopz94/virtual-office-muse-ai90MIT

Migawka bazy z 13.11.2026 · wersja paczki 2a32762aedd1 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 89code-review
    Przegląda kod AEM Edge Delivery Services pod kątem struktury bloków, wzorców CSS i JS, wydajności Lighthouse oraz dostępności i publikuje uwagi jako komentarze w pull requeście.
  • 100aem-cli
    Pomaga instalować, uruchamiać i konfigurować Adobe AEM CLI (dawniej helix-cli): aem up, import, content, lokalny serwer Edge Delivery, zmienne AEM_*, HTTPS oraz naprawę błędów aem up.
  • 90Code Review
    Przegląda kod projektów AEM Edge Delivery Services przed commitem lub w pull requestach, z sugestiami zmian w GitHub.
  • 100aem-page-search
    Wyszukuje strony AEM używające danego komponentu i podaje klikalne adresy URL do edycji w środowisku autorskim.
  • 100aem-component
    Znajduje pliki źródłowe, strony AEM i pola dialogu wskazanego komponentu Adobe Experience Manager, gdy trzeba ustalić, gdzie komponent jest zdefiniowany.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.