oc_skill_recall
Read-onlyIdempotent
Retrieve recency-sorted skills for a domain from the skill memory store. Optionally filter by contract ID and limit results for efficient recall.
Instructions
Retrieve skills from the JSON skill memory store for a given domain. Returns a recency-sorted list (last_used_at desc). Optionally filter by contract_id and cap results with limit (default 20). No LLM ranking — deterministic store order is returned as-is unless task/query or ranked is supplied. Each result carries codegenReplay ({available, artifacts}) for the LLM-free replay fast path. Use oc_skill_record to write skills.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | Domain to retrieve skills for (e.g. "amazon.com"). Must be a non-empty string ≤ 253 chars and match the domain used at record time. | |
| contract_id | No | Optional. Restrict results to skills whose contract_id matches this value exactly. Omit to return skills across all contracts. | |
| task | No | Optional task text. When present, recall is ranked by deterministic task relevance. | |
| query | No | Optional alias for task. Ignored when task is also provided. | |
| ranked | No | Opt in to deterministic ranked recall. Also enabled when task is provided. | |
| limit | No | Maximum number of skills to return. Default 20. Pass 0 to return an empty list. Values below 0 are treated as 0. | |
| include_unpromoted | No | When true, also surface promotionState=recorded skills. Default false: once a domain has any re_verified/recallable skill, recall hides recorded ones to keep the LLM-free fast path safe. Domains with no promoted skill auto-fallback to v1.x (all non-quarantined surface). (#1431) | |
| include_quarantined | No | When true, also surface promotionState=quarantined skills. Default false; diagnostic only — they failed re-verification and should not be replayed. Independent of the recorded/promoted filter, so on an unpromoted domain (v1.x auto-fallback) it yields recorded + quarantined. (#1431) | |
| use_run_stats | No | Opt in to factor audit-log run statistics (recent-window failure rate) into ranked recall, demoting skills that fail often. Implies ranked recall. Default false (no audit-log I/O when off). When on, does a one-time synchronous audit-log scan per call. (#1457) |