Menu
Web search via Tavily's research-grade API. Returns ranked results per query envelope.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Append one hash-chained audit event to okrs/<id>/audit/events/<run-id>.jsonl. Returns the new chain head.
Replay the hash chain over an existing audit JSONL; returns the chain head on success, the first integrity failure reason on failure.
Query the mesh's threat library for entries matching a concern (e.g. "identity", "data-licensing").
Academic paper search via arXiv. Returns ranked paper results per query envelope.
Aggregated architecture context for a scope — CALM nodes + ADRs + fitness functions + quality attributes. PURE data; the Architect persona is in the parent agent's prompt.
Aggregated quality context for a scope — quality attribute definitions + performance SLOs + reliability targets per BAR.
| name | tavily-search |
| description | Web search via Tavily's research-grade API. Returns ranked results per query envelope. |
| version | 0.1.0 |
| purity | pure-data |
| runtime | research-runner |
| command | npx @maintainabilityai/research-runner@~0.1.64 skill-tavily-search |
| secrets | ["TAVILY_API_KEY"] |
Call when the agent needs structured web search results for OKR / PRD research. PURE-data: no LLM reasoning inside; the parent agent generates queries itself and inspects results itself.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
queries | string[] | yes | — | Web queries the agent crafts. WHY audit expects each query to include the current 4-digit year plus a subject/concept anchor. |
maxResults | integer | no | 10 | Per-query result cap. |
| Field | Type | Description |
|---|---|---|
envelopes | {query, status, count, error?}[] | One per query — surfaces per-query failures without blocking the others. |
results | ProviderResult[] | Flattened ranked list across envelopes. |
echo '{"queries":["celebrity data licensing GDPR 2026"],"maxResults":10}' \
| npx @maintainabilityai/research-runner@~0.1.64 skill-tavily-search
Thin wrapper over packages/research-runner/src/search/tavily-client.ts. The CLI subcommand backend lands in B-PR1a; this SKILL.md is in place so B-PR2 agents can declare it in tools:.
On terminal failure (auth, network exhausted), exits non-zero and writes {ok: false, reason} to stdout. The agent treats this as "continue with remaining providers' results" per §5.5.3.