Przejdź do treści
Biblioteka skilli
AI i agenci · Research

docs-search

/docs-search

Przeszukuje dokumentację tak, by agenty dostawały trafne odpowiedzi: indeksuje źródła, precyzyjnie zapytuje i podaje cytowania.

Licencja
MIT
Ostatnia zmiana repozytorium
11.11.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Przeszukuje dokumentację tak, by agenty dostawały trafne odpowiedzi: indeksuje źródła, precyzyjnie zapytuje i podaje cytowania.

Oryginalny opis (EN)

Search documentation effectively for agents: index docs, query precisely, and cite sources. Use when agents need accurate answers from documentation rather than guesses.

Jak działa

  1. Overview
  2. When to use
  3. Core concepts
  4. Practical workflow
  5. Common pitfalls
Sekcje z nagłówków SKILL.md, w oryginale · 76 linii, 531 słów
Podgląd SKILL.md
---
name: docs-search
description: Search documentation effectively for agents: index docs, query precisely, and cite sources. Use when agents need accurate answers from documentation rather than guesses.
category: ai-maestro
---

# Docs Search

## Overview

Agents hallucinate when they guess; docs search grounds them in written sources. The pattern: indexed documentation, precise queries, cited answers.

Effective docs search for agents means: curated doc sets, chunked and indexed content, query expansion, and answers that cite their sources.

Goal: every factual claim traceable to a doc passage — no confident inventions.

## When to use

- Agent answering questions from documentation
- Building a knowledge base agents can query
- Reducing hallucinations in agent responses
- Onboarding agents to a codebase or product
- Keeping agent answers current with doc updates

## Core concepts

- **Curated doc sets.**
  Index the right docs: official, current, complete. Garbage in, garbage out — curation beats index size.
- **Chunking.**
  Split docs into retrievable passages (sections, not whole pages). Good chunks: self-contained, titled, with context.
- **Query expansion.**
  Expand user questions into 2-3 search phrasings, including synonyms and related terms. One phrasing misses; several hit.
- **Hybrid retrieval.**
  Keyword (BM25) + semantic (embeddings) together. Keywords catch exact terms; semantics catch paraphrases. Hybrid beats either alone.
- **Reranking.**
  Rerank top candidates with a stronger model/scorer before answering. Retrieval gets candidates; reranking picks winners.
- **Cited answers.**
  Every claim linked to its source passage. Citations let humans verify and agents stay honest.
- **Freshness.**
  Docs change; indexes must follow. Re-index on doc updates; flag answers sourced from outdated passages.
- **Fallback honesty.**
  No good source found? Say so. 'Not in the docs' beats a fabricated answer every time.

## Practical workflow

1. **Curate the corpus.**
   Select authoritative, current docs. Exclude drafts, duplicates, and deprecated versions. Document what's indexed.
2. **Chunk and index.**
   Section-level chunks with titles and metadata (source, version, date). Build keyword + semantic indexes.
3. **Expand queries.**
   For each question: 2-3 phrasings with synonyms. Search all; merge and dedupe results.
4. **Retrieve and rerank.**
   Hybrid retrieval for candidates, rerank top 20 -> top 5. Quality over quantity in the answer context.
5. **Answer with citations.**
   Compose from retrieved passages only; cite each claim to its passage. No source = no claim.
6. **Handle gaps honestly.**
   Weak or no sources: say what's missing, suggest where to look. Never fill gaps with invention.
7. **Maintain freshness.**
   Re-index on doc changes; version the index; surface source dates in answers.
8. **Evaluate regularly.**
   Test questions with known answers; measure retrieval hit rate and answer accuracy. Improve chunking/queries from failures.

## Common pitfalls

- **Uncurated indexes.**
  Indexing everything including drafts and deprecated docs. Stale/wrong sources produce confident wrong answers.
- **Whole-page chunks.**
  Retrieving 5,000-word pages as 'passages.' Chunk by section; precision matters.
- **Single-phrasing queries.**
  One literal query missing paraphrased content. Expand phrasings or miss half the corpus.
- **Citation-free answers.**
  Fluent answers with no sources. Unverifiable = untrustworthy, however fluent.
- **Fabrication on gaps.**
  No source found, answer invented anyway. The cardinal sin of docs search — always admit gaps.
- **Stale indexes.**
  Docs updated, index months old. Answers cite superseded information confidently.
- **Keyword-only or semantic-only.**
  Each misses what the other catches. Hybrid retrieval is the standard for a reason.
- **No evaluation.**
  Never testing whether retrieval actually works. A test set of known Q&A pairs keeps the system honest.
Pliki w paczce (4)
  • ATTRIBUTION.md 1 KB
  • INSTALL-NOTES.md 1 KB
  • SKILL.md 4 KB
  • skill.yaml 1 KB

Wersje

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

Migawka bazy z 13.11.2026 · wersja paczki 6b1300a0448a (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

  • 100agents-md-fixer
    Odchudza rozdęte pliki AGENTS.md do zwięzłych odnośników do kanonicznych reguł w docs/*.md, gdy wskazówki dla agentów dublują dokumentację repozytorium.
  • 100session-finder
    Indeksuje i przeszukuje sesje Claude Code za pomocą osadzeń semantycznych Gemini, znajduje dawne sesje po temacie i uruchamia ponownie trafne dopasowanie.
  • 100search-specialist
    Wyszukuje precyzyjnie konkretne informacje w wielu źródłach, optymalizując zapytania, bez analizowania treści.
  • 100docs-sources
    Opisuje platformy dokumentacji i strategie pobierania: dodawanie nowych źródeł, dobór strategii dla strony docs, wykrywanie frameworków dokumentacji i konfigurację rejestru dokumentacji.
  • 100engraph
    Indeksuje i przeszukuje kolekcje dokumentów metodą hybrydową, semantyczną, grafową i pełnotekstową, pomagając znajdować powiązania między dokumentami w zbiorach markdown.
  • 100sync-docs
    Synchronizuje oficjalną dokumentację Anthropic i analizuje wpływ zmian na walidator skilli, pluginy i dokumentację projektu, uruchamiając skrypt update-claude-docs.sh.

Uwagi i zgłoszenia

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