research

Research

Use the installed arks CLI for long-running, Provider-backed synthesis. Start with research.run, then review its consequential conclusions and fill specific evidence gaps. Search and Fetch support that review; they are not a substitute for the initial Research run. The web Skill can guide those operations, but the review instructions below also work without an installed sibling Skill.

Readiness

1. Run arks --version. If unavailable, explain that ArkSpace CLI is required and ask before changing the user's environment.
2. Run arks doctor --json when Provider readiness is unknown. If credentials are missing, direct the human to run arks setup in a trusted local terminal. Never ask for an API key in conversation or place one in a command argument.
3. Ask before changing configuration or the user's environment. Force Exa or Tavily only when the user requests it; otherwise preserve configured key handling and safe fallback.

Scope

Write a concrete prompt that states:

• the question, audience, intended decision, and what a useful answer must establish;
• date, geography, or entity boundaries;
• required comparisons and exclusions;
• source requirements for consequential claims;
• the desired report structure and any deadline.

Clarify only missing information that would change the investigation or deliverable; otherwise state assumptions and proceed. Scope the extra source-review calls separately from the remote job using the bounds in Evidence review.

Choose concise for a narrow answer, standard for an ordinary multi-source report, and deep only when broader coverage justifies higher latency and Provider cost. Depth selects Provider quality controls, not a guaranteed number of research passes. Protocol v1 has an operation timeout, not a common hard cost or query budget.

Run

Create a temporary Protocol v1 request:

{
  "protocolVersion": 1,
  "capability": "research.run",
  "input": {
    "prompt": "Compare the current authentication models of these APIs. Prefer official documentation, cite material claims, and identify unresolved differences.",
    "depth": "standard",
    "timeoutMs": 600000
  }
}