How do I install the Web Research skill?

Run npx skillmds@latest add tomevault-io/web-research-13 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Web Research safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Web Research?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Web Research free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Web Research?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Web Research by tomevault-io — Agent Skill

Name: Web Research
Author: tomevault-io

File contents

Skill: Web Research

3-layer search: cache → SearxNG (Docker auto-start) → Claude WebSearch. Inspired by FAIR-Perplexica.

When to use

User asks about external technology (versions, APIs, configs)
Gap detected: CVE, deprecation, compatibility question
Tech-research-agent needs web sources for investigation
Developer encounters error from external library

What it produces

Search results — reranked by relevance, cached locally
Inline citations — [web:N] with source URLs in footer
Follow-up suggestions — contextual next commands
Gap detection — automatic suggestion when external gap detected

Prerequisites

1. Python 3.x available                    → always true in pm-workspace
2. Docker (optional) for SearxNG           → graceful fallback if missing
3. Internet connection (optional)           → cache-only mode if offline

Flow

User query or gap detected
  → Sanitize (strip PII, projects, emails, IPs)
  → Check cache (TTL by category)
  → If miss: try SearxNG (auto-start Docker)
  → If SearxNG unavailable: use Claude WebSearch
  → Rerank results (keyword + domain authority)
  → Cache results
  → Format with [web:N] citations
  → Show follow-up suggestions

Key modules

Module	Lines	Purpose
`cache.py`	137	LRU cache, TTL, stats
`sanitizer.py`	107	PII removal, classification
`rerank.py`	86	Heuristic scoring
`formatter.py`	88	Citation formatting
`gap_detector.py`	110	External vs internal detection
`searxng.py`	149	Docker auto-start, cross-platform
`search.py`	88	3-layer orchestrator
`suggestions.py`	81	Post-command follow-ups

Scrapling enrichment (SE-061)

Para URLs resultantes de SearxNG/WebSearch que requieren extracción de contenido (más allá de snippet), invocar el wrapper adaptativo scripts/scrapling-fetch.sh:

bash scripts/scrapling-fetch.sh "${URL}" --json --timeout 25

Backend scrapling si está instalado: bypass Cloudflare/DataDome nativo
Fallback transparente a curl con user-agent SaviaResearch/1.0
Exit 0/1/2, JSON con status|title|url_final|text|backend

Usar cuando WebFetch tool devuelve 403/429/503 o cuando el snippet no es suficiente. No usar para fetch masivo sin respetar robots.txt — ver docs/rules/domain/research-stack.md.

References

Spec: docs/propuestas/SPEC-003-web-research-system.md
Scrapling backend: docs/propuestas/SE-061-scrapling-research-backend.md
Config: docs/rules/domain/web-research-config.md
Stack chain: docs/rules/domain/research-stack.md
Docs ES: docs/web-research.md
Docs EN: docs/web-research.en.md
Tests: tests/test-web-research.bats

Source: gonzalezpazmonica/pm-workspace — distributed by TomeVault.

---name: web-research-13description: Search the web to resolve context gaps — documentation, versions, CVEs, best practices. Auto-starts SearxNG Docker if available, falls back to WebSearch. Use when this capability is needed.---# Skill: Web Research> 3-layer search: cache → SearxNG (Docker auto-start) → Claude WebSearch.> Inspired by [FAIR-Perplexica](https://github.com/UB-Mannheim/FAIR-Perplexica).## When to use- User asks about external technology (versions, APIs, configs)- Gap detected: CVE, deprecation, compatibility question- Tech-research-agent needs web sources for investigation- Developer encounters error from external library## What it produces1. **Search results** — reranked by relevance, cached locally2. **Inline citations** — `[web:N]` with source URLs in footer3. **Follow-up suggestions** — contextual next commands4. **Gap detection** — automatic suggestion when external gap detected## Prerequisites```1. Python 3.x available → always true in pm-workspace2. Docker (optional) for SearxNG → graceful fallback if missing3. Internet connection (optional) → cache-only mode if offline```## Flow```User query or gap detected → Sanitize (strip PII, projects, emails, IPs) → Check cache (TTL by category) → If miss: try SearxNG (auto-start Docker) → If SearxNG unavailable: use Claude WebSearch → Rerank results (keyword + domain authority) → Cache results → Format with [web:N] citations → Show follow-up suggestions```## Key modules| Module | Lines | Purpose ||--------|-------|---------|| `cache.py` | 137 | LRU cache, TTL, stats || `sanitizer.py` | 107 | PII removal, classification || `rerank.py` | 86 | Heuristic scoring || `formatter.py` | 88 | Citation formatting || `gap_detector.py` | 110 | External vs internal detection || `searxng.py` | 149 | Docker auto-start, cross-platform || `search.py` | 88 | 3-layer orchestrator || `suggestions.py` | 81 | Post-command follow-ups |## Scrapling enrichment (SE-061)Para URLs resultantes de SearxNG/WebSearch que requieren extracción de contenido (más allá de snippet), invocar el wrapper adaptativo `scripts/scrapling-fetch.sh`:```bashbash scripts/scrapling-fetch.sh "${URL}" --json --timeout 25```- Backend `scrapling` si está instalado: bypass Cloudflare/DataDome nativo- Fallback transparente a `curl` con user-agent `SaviaResearch/1.0`- Exit 0/1/2, JSON con `status|title|url_final|text|backend`Usar cuando WebFetch tool devuelve 403/429/503 o cuando el snippet no es suficiente. No usar para fetch masivo sin respetar robots.txt — ver `docs/rules/domain/research-stack.md`.## References- Spec: `docs/propuestas/SPEC-003-web-research-system.md`- Scrapling backend: `docs/propuestas/SE-061-scrapling-research-backend.md`- Config: `docs/rules/domain/web-research-config.md`- Stack chain: `docs/rules/domain/research-stack.md`- Docs ES: `docs/web-research.md`- Docs EN: `docs/web-research.en.md`- Tests: `tests/test-web-research.bats`---> Source: [gonzalezpazmonica/pm-workspace](https://github.com/gonzalezpazmonica/pm-workspace) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions

Web Research