CLI contract

Resolve, audit, and install agent skills from the terminal.

OpenAgentSkill CLI turns a natural-language task into a selected skill, safety policy decision, target-specific install handoff, and audit trail.

View API contract Try resolve endpoint

Resolve

Resolve a task into one safe install plan

Calls /api/agent/resolve and returns the selected skill, alternatives, safety profile, and install prompt.

openagentskill resolve "scrape competitor pricing pages" --agent codex --max-risk medium

Lock

Generate a stable agent lockfile

Returns a small OpenAgentSkill lock object with selected skill, install policy, risk notes, alternatives, and outcome event id.

openagentskill lock "analyze stock news" --agent codex --json

Receipt

Fetch the pre-install receipt

Gets the stable install receipt agents should read before installing a third-party skill in a workspace.

openagentskill receipt "parse a PDF and extract tables" --agent claude-code

Pack

Pull a complete workflow pack

Fetches scenario-level install order, audit URLs, review checklist, and outcome feedback contract for a skill pack.

openagentskill pack presentation-agent-pack --limit 6 --json

Install

Fetch target-specific install handoffs

Returns Codex, Claude Code, Cursor, and CLI install handoffs from the canonical skill record.

openagentskill install crawl4ai --agent claude-code

Outcome

Report whether the skill worked

Posts the result back to /api/agent/outcome so Trust Score v5 and rankings learn from real agent runs. Use --dry-run when wiring an integration.

openagentskill outcome resolve_... --skill crawl4ai --task "scrape pricing pages" --agent codex --outcome success --install-used --output-quality 4 --workspace sandbox

Evaluate

Check recommendation quality

Runs the public recommendation benchmark so ranking changes can be checked before deployment.

openagentskill evals

Resolve API

The CLI is a thin layer over the agent control plane.

The important product surface is the decision object: selected skill, alternatives, policy result, safety score, install plan, benchmark link, and outcome event. Agents can call the same endpoint directly without opening a browser, then report the result after one narrow run.

Request

{
  "task": "review a pull request and summarize risky changes",
  "agent": "codex",
  "constraints": {
    "max_risk": "medium",
    "needs_install_command": true,
    "min_stars": 500
  }
}

Agent lockfile

{
  "version": "openagentskill-resolve-lock-v1",
  "task": "analyze stock news",
  "selected_skill": {
    "slug": "serenity-skill",
    "name": "Serenity Skill"
  },
  "install": {
    "command": "npx skills add muxuuu/serenity-skill",
    "policy": "human_review"
  },
  "outcome_feedback": {
    "endpoint": "/api/agent/outcome",
    "event_id": "resolve_..."
  }
}