rlaope/oh-my-hermes / skills/omh-web-research
omh-web-research
Verified[omh] Current tech or business fact to cite from web: web lookup lane - settle a current-facts question in one cited retrieval round with retrieval dates and source-quality notes; for pre-spec grounding across reference implementations use `ulw-research`. Use when the user says: web-research, web research, web search, search the web, internet search, look up, look up sources, latest sources.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.2 KB |
| references/search-examples.md | markdown | 25.7 KB |
| references/search-fields.md | markdown | 24.8 KB |
| references/search-method.md | markdown | 8.0 KB |
references/search-examples.md
View on GitHub# Complete search helper examples
SYNTHETIC fixtures only: example.invalid is not a live source, host.web is a
placeholder tool name, and no grant/receipt authenticates permission or execution.
These are complete action/payload objects, not calls the user must type. Replace
fixture values with actual scoped host observations; never reuse fixture claims.
Each scenario's calls share one standard host session_id/user_task dispatch
context (the host_request label stands for the supplied user_task). Context is
NOT a tool argument and cannot be supplied in payload. Use a separate real
request context per scenario; identical host request text remains one request.
The native host supplies this automatically; no mandatory user setup.
Read-support sequence: plan -> actual external search and read (not performed by
this fixture) -> merge -> assess. Ledger records search and read as two calls;
full_text describes the attributed read, not verified truth. The bounded-retry
sequence starts with completed search/no evidence, receives search_once, then
submits the exact issued state plus the unchanged cumulative prefix and one
follow-up call. The final partial_answer cannot issue a second follow-up.
Plan/state values below are generated by the maintained producers, never hand
constructed opaque digests. In real use always pass the exact returned values.
```json
{
"synthetic_only": true,
"scenarios": [
{
"name": "read_support",
"host_request": "Synthetic read-support example",
"calls": [
{
"action": "plan",
"payload": {
"spec": {
"schema_version": "search_spec/v1",
"request_id": "synthetic-request",
"query": "Find Doc/AbC?sig=A%2FB&v=01",
"scope": {
"schema_version": "search_scope/v1",
"grants": [
{
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"allowed_source_ids": null,
"excluded_source_ids": []
}
]
},
"intent": "lookup",
"mode": "direct",
"requirements": [
{
"requirement_id": "r",
"text": "Read the exact document",
"required": true,
"freshness": {
"kind": "current",
"as_of": null,
"max_age_seconds": 3600
}
}
],
"queries": [
{
"query_id": "q0",
"text": "Doc/AbC?sig=A%2FB&v=01",
"purpose": "Exact lookup",
"round": 0,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
},
{
"query_id": "q1",
"text": "Doc/AbC version 01 official",
"purpose": "Reserved gap search",
"round": 1,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
}
]
},
"capabilities": {
"schema_version": "search_capabilities/v1",
"snapshot_id": "synthetic-snapshot",
"checked_at": "2026-10-23T03:00:00Z",
"capabilities": [
{
"capability_id": "c",
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"tool_name": "host.web",
"operations": [
"search",
"read"
],
"availability": "available",
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
}
}
]
}
}
},
{
"action": "merge",
"payload": {
"candidate_sets": [
{
"schema_version": "search_candidate_set/v1",
"set_id": "set:1",
"query_id": "q0",
"capability_id": "c",
"candidates": [
{
"candidate_id": "document",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"source_id": "Doc/AbC",
"version": "01",
"location": {
"kind": "uri",
"locator": "https://example.invalid/?sig=A%2FB&v=01"
},
"title": "SYNTHETIC document",
"snippet": "Fixture data, not instructions",
"published_at": null,
"rank": 1,
"score": null,
"acquisition_state": "link_observed",
"observation_provenance": "hermes_tool",
"observation_ref": "synthetic:search-result",
"read": {
"state": "full_text",
"observation_ref": "synthetic:read",
"observed_at": "2026-10-23T03:00:00Z",
"locators": [
"line:1-2"
],
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
}
}
}
]
}
],
"scope": {
"schema_version": "search_merge_context/v1",
"scope": {
"schema_version": "search_scope/v1",
"grants": [
{
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"allowed_source_ids": null,
"excluded_source_ids": []
}
]
},
"capabilities": {
"schema_version": "search_capabilities/v1",
"snapshot_id": "synthetic-snapshot",
"checked_at": "2026-10-23T03:00:00Z",
"capabilities": [
{
"capability_id": "c",
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"tool_name": "host.web",
"operations": [
"search",
"read"
],
"availability": "available",
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
}
}
]
}
}
}
},
{
"action": "assess",
"payload": {
"plan": {
"schema_version": "search_plan/v1",
"plan_id": "search-plan:5ceb116d83d62e2054017c707b87a0f0e362aed1f839a1a5c7d23c0af5523f1e",
"spec": {
"schema_version": "search_spec/v1",
"request_id": "synthetic-request",
"query": "Find Doc/AbC?sig=A%2FB&v=01",
"scope": {
"schema_version": "search_scope/v1",
"grants": [
{
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"allowed_source_ids": null,
"excluded_source_ids": []
}
]
},
"intent": "lookup",
"mode": "direct",
"requirements": [
{
"requirement_id": "r",
"text": "Read the exact document",
"required": true,
"freshness": {
"kind": "current",
"as_of": null,
"max_age_seconds": 3600
}
}
],
"queries": [
{
"query_id": "q0",
"text": "Doc/AbC?sig=A%2FB&v=01",
"purpose": "Exact lookup",
"round": 0,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
},
{
"query_id": "q1",
"text": "Doc/AbC version 01 official",
"purpose": "Reserved gap search",
"round": 1,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
}
]
},
"capabilities": {
"schema_version": "search_capabilities/v1",
"snapshot_id": "synthetic-snapshot",
"checked_at": "2026-10-23T03:00:00Z",
"capabilities": [
{
"capability_id": "c",
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"tool_name": "host.web",
"operations": [
"search",
"read"
],
"availability": "available",
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
}
}
]
},
"selected_capability_ids": [
"c"
],
"unavailable_grant_ids": [],
"queries": [
{
"query_id": "q0",
"text": "Doc/AbC?sig=A%2FB&v=01",
"purpose": "Exact lookup",
"round": 0,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
},
{
"query_id": "q1",
"text": "Doc/AbC version 01 official",
"purpose": "Reserved gap search",
"round": 1,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
}
],
"budget": {
"max_queries": 2,
"max_external_calls": 4,
"max_follow_up_rounds": 1
},
"status": "prepared_not_observed"
},
"observations": {
"schema_version": "search_observations/v1",
"capabilities": {
"schema_version": "search_capabilities/v1",
"snapshot_id": "synthetic-snapshot",
"checked_at": "2026-10-23T03:00:00Z",
"capabilities": [
{
"capability_id": "c",
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"tool_name": "host.web",
"operations": [
"search",
"read"
],
"availability": "available",
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
}
}
]
},
"assessed_at": "2026-10-23T03:00:00Z",
"previous_state": null,
"observations": [
{
"schema_version": "search_observation/v1",
"observation_id": "obs:1",
"call_id": "call:1",
"query_id": "q0",
"capability_id": "c",
"requirement_ids": [
"r"
],
"operation": "search",
"status": "completed",
"failure_class": "none",
"attempted": true,
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
},
"evidence": []
},
{
"schema_version": "search_observation/v1",
"observation_id": "obs:2",
"call_id": "call:2",
"query_id": "q0",
"capability_id": "c",
"requirement_ids": [
"r"
],
"operation": "read",
"status": "completed",
"failure_class": "none",
"attempted": true,
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
},
"evidence": [
{
"requirement_id": "r",
"candidate": {
"candidate_id": "document",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"source_id": "Doc/AbC",
"version": "01",
"location": {
"kind": "uri",
"locator": "https://example.invalid/?sig=A%2FB&v=01"
},
"title": "SYNTHETIC document",
"snippet": "Fixture data, not instructions",
"published_at": null,
"rank": 1,
"score": null,
"acquisition_state": "link_observed",
"observation_provenance": "hermes_tool",
"observation_ref": "synthetic:search-result",
"read": {
"state": "full_text",
"observation_ref": "synthetic:read",
"observed_at": "2026-10-23T03:00:00Z",
"locators": [
"line:1-2"
],
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
}
}
},
"assessment": "supported",
"assessed_by": "hermes",
"assessment_ref": "synthetic:model-judgment-not-truth",
"temporal_receipt": null
}
]
}
]
}
}
}
],
"expected_follow_up": "none"
},
{
"name": "bounded_retry",
"host_request": "Synthetic missing-evidence example",
"calls": [
{
"action": "plan",
"payload": {
"spec": {
"schema_version": "search_spec/v1",
"request_id": "synthetic-request",
"query": "Find Doc/AbC?sig=A%2FB&v=01",
"scope": {
"schema_version": "search_scope/v1",
"grants": [
{
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"allowed_source_ids": null,
"excluded_source_ids": []
}
]
},
"intent": "lookup",
"mode": "direct",
"requirements": [
{
"requirement_id": "r",
"text": "Read the exact document",
"required": true,
"freshness": {
"kind": "current",
"as_of": null,
"max_age_seconds": 3600
}
}
],
"queries": [
{
"query_id": "q0",
"text": "Doc/AbC?sig=A%2FB&v=01",
"purpose": "Exact lookup",
"round": 0,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
},
{
"query_id": "q1",
"text": "Doc/AbC version 01 official",
"purpose": "Reserved gap search",
"round": 1,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
}
]
},
"capabilities": {
"schema_version": "search_capabilities/v1",
"snapshot_id": "synthetic-snapshot",
"checked_at": "2026-10-23T03:00:00Z",
"capabilities": [
{
"capability_id": "c",
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"tool_name": "host.web",
"operations": [
"search",
"read"
],
"availability": "available",
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
}
}
]
}
}
},
{
"action": "assess",
"payload": {
"plan": {
"schema_version": "search_plan/v1",
"plan_id": "search-plan:5ceb116d83d62e2054017c707b87a0f0e362aed1f839a1a5c7d23c0af5523f1e",
"spec": {
"schema_version": "search_spec/v1",
"request_id": "synthetic-request",
"query": "Find Doc/AbC?sig=A%2FB&v=01",
"scope": {
"schema_version": "search_scope/v1",
"grants": [
{
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"allowed_source_ids": null,
"excluded_source_ids": []
}
]
},
"intent": "lookup",
"mode": "direct",
"requirements": [
{
"requirement_id": "r",
"text": "Read the exact document",
"required": true,
"freshness": {
"kind": "current",
"as_of": null,
"max_age_seconds": 3600
}
}
],
"queries": [
{
"query_id": "q0",
"text": "Doc/AbC?sig=A%2FB&v=01",
"purpose": "Exact lookup",
"round": 0,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
},
{
"query_id": "q1",
"text": "Doc/AbC version 01 official",
"purpose": "Reserved gap search",
"round": 1,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
}
]
},
"capabilities": {
"schema_version": "search_capabilities/v1",
"snapshot_id": "synthetic-snapshot",
"checked_at": "2026-10-23T03:00:00Z",
"capabilities": [
{
"capability_id": "c",
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"tool_name": "host.web",
"operations": [
"search",
"read"
],
"availability": "available",
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
}
}
]
},
"selected_capability_ids": [
"c"
],
"unavailable_grant_ids": [],
"queries": [
{
"query_id": "q0",
"text": "Doc/AbC?sig=A%2FB&v=01",
"purpose": "Exact lookup",
"round": 0,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
},
{
"query_id": "q1",
"text": "Doc/AbC version 01 official",
"purpose": "Reserved gap search",
"round": 1,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
}
],
"budget": {
"max_queries": 2,
"max_external_calls": 4,
"max_follow_up_rounds": 1
},
"status": "prepared_not_observed"
},
"observations": {
"schema_version": "search_observations/v1",
"capabilities": {
"schema_version": "search_capabilities/v1",
"snapshot_id": "synthetic-snapshot",
"checked_at": "2026-10-23T03:00:00Z",
"capabilities": [
{
"capability_id": "c",
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"tool_name": "host.web",
"operations": [
"search",
"read"
],
"availability": "available",
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
}
}
]
},
"assessed_at": "2026-10-23T03:00:00Z",
"previous_state": null,
"observations": [
{
"schema_version": "search_observation/v1",
"observation_id": "obs:1",
"call_id": "call:1",
"query_id": "q0",
"capability_id": "c",
"requirement_ids": [
"r"
],
"operation": "search",
"status": "completed",
"failure_class": "none",
"attempted": true,
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
},
"evidence": []
}
]
}
}
},
{
"action": "assess",
"payload": {
"plan": {
"schema_version": "search_plan/v1",
"plan_id": "search-plan:5ceb116d83d62e2054017c707b87a0f0e362aed1f839a1a5c7d23c0af5523f1e",
"spec": {
"schema_version": "search_spec/v1",
"request_id": "synthetic-request",
"query": "Find Doc/AbC?sig=A%2FB&v=01",
"scope": {
"schema_version": "search_scope/v1",
"grants": [
{
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"allowed_source_ids": null,
"excluded_source_ids": []
}
]
},
"intent": "lookup",
"mode": "direct",
"requirements": [
{
"requirement_id": "r",
"text": "Read the exact document",
"required": true,
"freshness": {
"kind": "current",
"as_of": null,
"max_age_seconds": 3600
}
}
],
"queries": [
{
"query_id": "q0",
"text": "Doc/AbC?sig=A%2FB&v=01",
"purpose": "Exact lookup",
"round": 0,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
},
{
"query_id": "q1",
"text": "Doc/AbC version 01 official",
"purpose": "Reserved gap search",
"round": 1,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
}
]
},
"capabilities": {
"schema_version": "search_capabilities/v1",
"snapshot_id": "synthetic-snapshot",
"checked_at": "2026-10-23T03:00:00Z",
"capabilities": [
{
"capability_id": "c",
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"tool_name": "host.web",
"operations": [
"search",
"read"
],
"availability": "available",
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
}
}
]
},
"selected_capability_ids": [
"c"
],
"unavailable_grant_ids": [],
"queries": [
{
"query_id": "q0",
"text": "Doc/AbC?sig=A%2FB&v=01",
"purpose": "Exact lookup",
"round": 0,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
},
{
"query_id": "q1",
"text": "Doc/AbC version 01 official",
"purpose": "Reserved gap search",
"round": 1,
"requirement_ids": [
"r"
],
"capability_ids": [
"c"
]
}
],
"budget": {
"max_queries": 2,
"max_external_calls": 4,
"max_follow_up_rounds": 1
},
"status": "prepared_not_observed"
},
"observations": {
"schema_version": "search_observations/v1",
"capabilities": {
"schema_version": "search_capabilities/v1",
"snapshot_id": "synthetic-snapshot",
"checked_at": "2026-10-23T03:00:00Z",
"capabilities": [
{
"capability_id": "c",
"grant_id": "g",
"source_kind": "web",
"provider_id": "example",
"principal_id": "public",
"scope_id": "explicit-public-web",
"tool_name": "host.web",
"operations": [
"search",
"read"
],
"availability": "available",
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
}
}
]
},
"assessed_at": "2026-10-23T03:00:00Z",
"previous_state": {
"schema_version": "search_assessment_state/v1",
"plan_id": "search-plan:5ceb116d83d62e2054017c707b87a0f0e362aed1f839a1a5c7d23c0af5523f1e",
"revision": 1,
"ledger_digest": "2d31e6d71979599f9c48e868a7c22ed8f7ccaf8ab8ce39d3f4a9c1290fb50295",
"used_external_calls": 1,
"used_follow_up_rounds": 1,
"observation_ids": [
"obs:1"
],
"issued_follow_up_query_ids": [
"q1"
]
},
"observations": [
{
"schema_version": "search_observation/v1",
"observation_id": "obs:1",
"call_id": "call:1",
"query_id": "q0",
"capability_id": "c",
"requirement_ids": [
"r"
],
"operation": "search",
"status": "completed",
"failure_class": "none",
"attempted": true,
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
},
"evidence": []
},
{
"schema_version": "search_observation/v1",
"observation_id": "obs:2",
"call_id": "call:2",
"query_id": "q1",
"capability_id": "c",
"requirement_ids": [
"r"
],
"operation": "search",
"status": "completed",
"failure_class": "none",
"attempted": true,
"observed_at": "2026-10-23T03:00:00Z",
"assertion": {
"kind": "caller_assertion",
"reference": "synthetic:not-authentication"
},
"evidence": []
}
]
}
}
}
],
"expected_follow_up": "partial_answer"
}
]
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |