Przejdź do treści
Biblioteka skilli
Nauka i badania · Research

agentic-search

/agentic-search

Prowadzi głęboki research webowy z cytatami, wspierany przez Tavily i Firecrawl: pobieranie stron do Markdown, mapowanie witryn, cytaty dosłowne, reranking źródeł i wielokrokowe sesje.

Repozytorium
webmaton ↗
Licencja
MIT
Ostatnia zmiana repozytorium
25.08.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
16
Skrypty
9
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

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

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

Skrypty: scripts/_http.py, scripts/_prompts.py, scripts/_session.py, scripts/agentic_extract.py, scripts/agentic_fetch.py, scripts/agentic_get_sources.py, scripts/agentic_map.py, scripts/agentic_rank.py

Co robi i kiedy

Prowadzi głęboki research webowy z cytatami, wspierany przez Tavily i Firecrawl: pobieranie stron do Markdown, mapowanie witryn, cytaty dosłowne, reranking źródeł i wielokrokowe sesje.

Oryginalny opis (EN)

Grok-primary deep research skill for source-backed web work. Use when the task needs current web research, grounded citations, supplementary Tavily/Firecrawl source discovery, high-fidelity page-to-Markdown fetch, Tavily site mapping, verbatim quote extraction, source reranking, or reusable multi-step research sessions. Use as a supplement when ordinary search results feel incomplete, thinly sourced, or need more URLs, quotes, fetched pages, or session composition; not for simple one-off facts.

Jak działa

  1. How to invoke
  2. Session workflow
  3. Operating discipline
  4. Failure modes
Sekcje z nagłówków SKILL.md, w oryginale · 55 linii, 367 słów
Podgląd SKILL.md
---
name: agentic-search
description: "Grok-primary deep research skill for source-backed web work. Use when the task needs current web research, grounded citations, supplementary Tavily/Firecrawl source discovery, high-fidelity page-to-Markdown fetch, Tavily site mapping, verbatim quote extraction, source reranking, or reusable multi-step research sessions. Use as a supplement when ordinary search results feel incomplete, thinly sourced, or need more URLs, quotes, fetched pages, or session composition; not for simple one-off facts."
---

# agentic-search

| # | Script | Intent |
|---|---|---|
| 1 | `scripts/agentic_search.py` | Research a topic — AI-reasoned answer with citations |
| 2 | `scripts/agentic_fetch.py` | Full page → Markdown, no summarization |
| 3 | `scripts/agentic_map.py` | Enumerate URLs under a site (Tavily-only) |
| 4 | `scripts/agentic_extract.py` | Verbatim title + 2–4 quotes from a URL |
| 5 | `scripts/agentic_rank.py` | Rerank session sources by a refined query |
| 6 | `scripts/agentic_get_sources.py` | Retrieve or list cached sessions |

## How to invoke

All scripts use PEP 723 inline deps — always invoke via `uv run`. Allow up to 3 minutes per call.

```bash
uv run scripts/agentic_search.py --query "..." [--extra-sources N] [--auto-fetch-top N] [--platform "..."]
uv run scripts/agentic_fetch.py --url "..." [--engine auto|tavily|firecrawl|grok]
uv run scripts/agentic_map.py --url "..." [--instructions "..."] [--limit N]
uv run scripts/agentic_extract.py --url "..." [--session-id S]
uv run scripts/agentic_rank.py --query "..." --session-id S
uv run scripts/agentic_get_sources.py --list | --session-id S
```

## Session workflow

`agentic_search` generates a `session_id` persisted to disk — the connective tissue for composing steps:

```
agentic_search → session_id
     ├─→ agentic_rank --session-id S --query Q     (rerank in place; mutates session)
     ├─→ agentic_extract --session-id S --url U    (append verbatim quotes)
     └─→ agentic_get_sources --session-id S        (inspect full session)
```

Sessions survive between invocations but may be cleared on OS reboot.

## Operating discipline

Load the relevant reference before composing a non-trivial query — don't load all four upfront.

- **`references/search-discipline.md`** — two-pass methodology, citation contract, time-context heuristic. Read for research tasks.
- **`references/fetch-fidelity.md`** — engine trade-offs, fidelity guarantees, when not to fetch. Read before presenting extracted content.
- **`references/extract-and-rank.md`** — extract vs fetch, when to rank, session composition patterns. Read for multi-step workflows.
- **`references/provider-quirks.md`** — env vars, provider schemas, retry policy, debugging. Read when configuring or debugging.

## Failure modes

- No `GROK_API_KEY` / `GROK_API_URL` → config error on any Grok-using script.
- `agentic_fetch --engine auto` total failure → retry with `--engine grok` or fall back to built-in `WebFetch`.
- `agentic_map` without `TAVILY_API_KEY` → hard exit.
- `agentic_rank --session-id S` session expired → re-run `agentic_search`.
- `sources_count: 0` with non-empty `content` → Grok used training data; check `providers_used` (`grok-web-search` = real citations, `grok` = heuristic fallback).
Pliki w paczce (16)
  • .env.search.template 3 KB
  • .gitignore 1 KB
  • SKILL.md 3 KB
  • references/extract-and-rank.md 3 KB
  • references/fetch-fidelity.md 5 KB
  • references/provider-quirks.md 3 KB
  • references/search-discipline.md 6 KB
  • scripts/_http.py 19 KB
  • scripts/_prompts.py 9 KB
  • scripts/_session.py 5 KB
  • scripts/agentic_extract.py 6 KB
  • scripts/agentic_fetch.py 8 KB
  • scripts/agentic_get_sources.py 2 KB
  • scripts/agentic_map.py 4 KB
  • scripts/agentic_rank.py 8 KB
  • scripts/agentic_search.py 35 KB

Wersje

W bazie nie ma innych skilli o nazwie agentic-search.

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

  • 100tavily-deep-research
    Wyszukuje w sieci, wyciąga treść z adresów URL i mapuje strukturę witryn przez Tavily w SandBase, także do czytania całych artykułów i szukania newsów.
  • 100tavily-web
    Prowadzi badania w sieci, wyszukuje źródła, pobiera treść stron, mapuje i przeszukuje witryny przez Tavily.
  • 100tavily-research
    Prowadzi pogłębiony research z cytatami przez CLI Tavily i zwraca ustrukturyzowany raport oparty na źródłach internetowych, na przykład porównania, analizy rynku i przeglądy literatury.
  • 100tavily-web
    Wyszukuje w sieci, wyciąga treść z adresów URL, crawluje witryny i prowadzi research przez API Tavily, gdy potrzebne są aktualne informacje.
  • 100tavily-web
    Wyszukuje w sieci, wyciąga treść z adresów URL, crawluje witryny i prowadzi research przez API Tavily, gdy potrzebne są aktualne informacje.
  • 100multi-search
    Wyszukuje równolegle w wielu źródłach (Web, Scholar, Smart, Tavily) z oceną pewności i syntezą AI, do badań wymagających krzyżowej walidacji źródeł.

Uwagi i zgłoszenia

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