This repository is an AI Agent skill for Socure RiskOS™. The skill guides you through a complete, working integration with the RiskOS™ Platform: from obtaining credentials and discovering use cases and workflows to implementing a client that calls a live Sandbox workflow, receives RiskOS™ decisions (Accept, Reject, or Review), and handles responses correctly. It uses RiskOS™ documentation and tools as the single source of truth and includes references such as the OpenAPI spec and consumer onboarding examples.
An Agent Skill is a modular capability that extends an AI agent’s behavior. Each skill packages instructions, metadata, and optional resources (e.g. scripts, specs) that the agent loads and uses when your request matches the skill’s purpose. Skills are reusable and filesystem-based, so you define them once and the agent applies them automatically in relevant conversations.
Skills use progressive loading: only the skill’s metadata is loaded up front; the main instructions and other files are read when the skill is triggered and when the agent needs them. That keeps context usage low while still giving the agent the right guidance and references for the task.
For more detail, see the Agent Skills overview.
Installation depends on which agent or IDE you use. Place the skill so the agent can see the repo root (with SKILL.md and references/). Many agents support the same folder layout; only the directory path changes.
- Project: Copy or clone this repo into
.cursor/skills/riskos-integration-skill/(or symlink the repo). - User (all projects): Use
~/.cursor/skills/riskos-integration-skill/. - From GitHub: Cursor Settings → Rules → Add Rule → Remote Rule (Github) → enter this repo’s URL.
Cursor also reads skills from .claude/skills/ and .codex/skills/ for compatibility. See Cursor Docs: Agent Skills.
- Workspace:
.windsurf/skills/riskos-integration-skill/(copy or symlink this repo there). - Global:
~/.codeium/windsurf/skills/riskos-integration-skill/.
You can also create the skill via the Cascade panel → ⋮ → Skills → + Workspace or + Global. See Windsurf Cascade Skills.
- Project:
.claude/skills/riskos-integration-skill/ - User:
~/.claude/skills/riskos-integration-skill/
- Project:
.codex/skills/riskos-integration-skill/or.agents/skills/riskos-skill/ - User:
~/.codex/skills/riskos-integration-skill/
Codex can also install skills via the built-in skill installer. See OpenAI Codex Skills.
From the repo root or with a GitHub reference:
npx skills add <owner>/riskos-integration-skillUse -g for user/global scope. Targets Cursor, Claude Code, Codex, and other agents that support the standard. See Install Agent Skills and agentskills.io.
- Claude API: Upload the skill via the Skills API (e.g. zip the repo, use
/v1/skills). Requires the beta headers for Skills and code execution (see Agent Skills overview). - claude.ai: Settings → Features → upload the skill as a zip (Pro, Max, Team, Enterprise with code execution).