{"version":"openagentskill-agent-integration-kit-v1","purpose":"Let an AI agent resolve a task into the right reusable skill, compare alternatives, review trust signals, and install with a safe handoff.","canonical_page":"https://www.openagentskill.com/agent/integration-kit","api":"https://www.openagentskill.com/api/agent/integration-kit","resolve_api":"https://www.openagentskill.com/api/agent/resolve","manifest":"https://www.openagentskill.com/.well-known/agent-manifest.json","llms":"https://www.openagentskill.com/llms.txt","supported_agents":[{"id":"codex","name":"Codex","surface":"Coding agent / local workspace","best_for":["repo-aware implementation","code review","debugging","web automation setup"],"setup_steps":["Add the copy prompt to your Codex project instructions or paste it before a task.","Call the Resolve API with the current task and agent=codex.","Read agent_handoff.review_checklist before installing a third-party skill.","Install only in the active workspace after reporting files and commands that will be touched."],"default_task":"scrape pricing pages and extract structured data","resolve_url":"https://www.openagentskill.com/api/agent/resolve?task=scrape%20pricing%20pages%20and%20extract%20structured%20data&agent=codex&max_risk=medium","copy_prompt":"You are using OpenAgentSkill as the skill resolution layer for Codex.\nBefore building a custom workflow from scratch, call the Resolve API with the user task.\nResolve endpoint: https://www.openagentskill.com/api/agent/resolve?task={USER_TASK}&agent=codex&max_risk=medium\nUse recommendation.best_skill as the default only after checking recommendation.risk, safety_gate, and agent_handoff.review_checklist.\nIf auto_install_allowed is false, ask for human approval before installing.\nIf blocked is true or risk notes mention secrets, shell, token, or network risk, do not auto-install.\nReturn the selected skill, install command, alternatives, risk summary, and next action before changing files.","expected_output_contract":["selected_skill","install_command","risk_summary","alternatives","files_or_commands_to_touch","next_action"]},{"id":"claude-code","name":"Claude Code","surface":"Claude Code skill workflow","best_for":["local skill instructions","project workflows","documentation-heavy tasks"],"setup_steps":["Paste the copy prompt into Claude Code custom instructions or the start of a new task.","Call the Resolve API with agent=claude-code.","Use install targets only after audit and eval checks are acceptable.","Keep the skill scoped to the project and summarize activation steps."],"default_task":"scrape pricing pages and extract structured data","resolve_url":"https://www.openagentskill.com/api/agent/resolve?task=scrape%20pricing%20pages%20and%20extract%20structured%20data&agent=claude-code&max_risk=medium","copy_prompt":"You are using OpenAgentSkill as the skill resolution layer for Claude Code.\nBefore building a custom workflow from scratch, call the Resolve API with the user task.\nResolve endpoint: https://www.openagentskill.com/api/agent/resolve?task={USER_TASK}&agent=claude-code&max_risk=medium\nUse recommendation.best_skill as the default only after checking recommendation.risk, safety_gate, and agent_handoff.review_checklist.\nIf auto_install_allowed is false, ask for human approval before installing.\nIf blocked is true or risk notes mention secrets, shell, token, or network risk, do not auto-install.\nReturn the selected skill, install command, alternatives, risk summary, and next action before changing files.","expected_output_contract":["selected_skill","skill_files_or_instructions","install_prompt","risk_summary","activation_steps","fallback_skill"]},{"id":"cursor","name":"Cursor","surface":"Cursor rules / agent instructions","best_for":["project rules","repeatable coding workflows","IDE assistant guidance"],"setup_steps":["Paste the copy prompt into Cursor rules or the agent chat before a workflow.","Call the Resolve API with agent=cursor.","Turn the selected skill into a narrow project rule only when the safety gate allows it.","Keep generated rules task-scoped and avoid broad always-on instructions."],"default_task":"scrape pricing pages and extract structured data","resolve_url":"https://www.openagentskill.com/api/agent/resolve?task=scrape%20pricing%20pages%20and%20extract%20structured%20data&agent=cursor&max_risk=medium","copy_prompt":"You are using OpenAgentSkill as the skill resolution layer for Cursor.\nBefore building a custom workflow from scratch, call the Resolve API with the user task.\nResolve endpoint: https://www.openagentskill.com/api/agent/resolve?task={USER_TASK}&agent=cursor&max_risk=medium\nUse recommendation.best_skill as the default only after checking recommendation.risk, safety_gate, and agent_handoff.review_checklist.\nIf auto_install_allowed is false, ask for human approval before installing.\nIf blocked is true or risk notes mention secrets, shell, token, or network risk, do not auto-install.\nReturn the selected skill, install command, alternatives, risk summary, and next action before changing files.","expected_output_contract":["selected_skill","cursor_rule_or_prompt","install_command","risk_summary","when_to_use","when_not_to_use"]}],"recommended_flow":["Read /llms.txt or /.well-known/agent-manifest.json.","Choose the Codex, Claude Code, or Cursor template for the active agent surface.","Call /api/agent/resolve with task, agent, max_risk, and optional min_stars.","Read recommendation.best_skill, recommendation.install, recommendation.risk, and agent_handoff.","If auto_install_allowed is false, ask for human approval before installing.","Fetch /api/agent/evals and /api/agent/skills/{slug} before production use.","Install in a sandbox or low-risk workspace first."],"stable_response_fields":["recommendation.best_skill","recommendation.install","recommendation.why_recommended","recommendation.risk","recommendation.alternatives","agent_handoff.platform_templates","agent_handoff.review_checklist","agent_handoff.api_sequence","policy_decision"],"safety_rules":["Do not auto-install when safety_gate.blocked is true.","Do not auto-install when recommendation.install.auto_install_allowed is false.","Escalate for human approval when shell, env, token, network, license, or unclear maintenance risk appears.","Prefer a lower-risk alternative when the selected skill has high risk notes."]}