Menu
Practitioner-community search via Hacker News Algolia API. Returns story + Show/Ask HN text 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 | hackernews-search |
| description | Practitioner-community search via Hacker News Algolia API. Returns story + Show/Ask HN text per query envelope. |
| version | 0.1.0 |
| purity | pure-data |
| runtime | research-runner |
| command | npx @maintainabilityai/research-runner@~0.1.64 skill-hackernews-search |
Call when the agent needs practitioner-grade qualitative signal (war stories, gotchas, current-state-of-tooling). PURE-data: agent crafts 2–3 word casual queries (e.g. name dedup, NOT identity disambiguation hacks).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
queries | string[] | yes | — | Short casual queries (HN search is keyword-naive). |
maxResults | integer | no | 10 | Per-query result cap. |
| Field | Type | Description |
|---|---|---|
envelopes | {query, status, count, error?}[] | Per-query envelope. |
results | ProviderResult[] | Flattened ranked list with storyText for Show HN / Ask HN posts. |
echo '{"queries":["name dedup"]}' \
| npx @maintainabilityai/research-runner@~0.1.64 skill-hackernews-search
Thin wrapper over packages/research-runner/src/search/hackernews-client.ts. No API key (Algolia free tier). The CLI subcommand backend lands in B-PR1a.
On terminal failure: exits non-zero with {ok: false, reason}. Agent continues with remaining providers.