riskmodels-api-discovery

riskmodels-api-discovery is a skill for Claude Code, Codex, Cursor from BlueWaterCorp/RiskModels_API. It costs 67 tokens per session (1,109 once invoked), scanned B, original, Apache-2.0.

A set of instructions for discovering the RiskModels API before writing code that calls it. RiskModels is a service that provides risk and portfolio-related data through an HTTP API.

In plain words
What is it for?
Use it before adding or changing Python or TypeScript API calls, SDK methods, CLI commands, MCP tools, or HTTP examples for riskmodels.app.
Why use it?
It helps prevent clients, examples, command-line tools, or MCP tools from using incorrect API paths, parameters, request bodies, or schemas.

Skill for Claude CodeCodexCursor

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/bluewatercorp/riskmodels_api/riskmodels-api-discovery
Any agent
npx skills add BlueWaterCorp/RiskModels_API --skill riskmodels-api-discovery
Clone the repo
git clone --depth 1 https://github.com/BlueWaterCorp/RiskModels_API

Made for: Claude Code, Codex, Cursor.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for riskmodels-api-discovery

README.md
[![agentmods](https://agentmods.dev/badge/skills/bluewatercorp/riskmodels_api/riskmodels-api-discovery.svg)](https://agentmods.dev/skills/bluewatercorp/riskmodels_api/riskmodels-api-discovery)
Your own site
<a href="https://agentmods.dev/skills/bluewatercorp/riskmodels_api/riskmodels-api-discovery"><img src="https://agentmods.dev/badge/skills/bluewatercorp/riskmodels_api/riskmodels-api-discovery.svg" alt="Measured on agentmods" height="20"></a>
Per session 67 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,109 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 2 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00067 $0.01109
Opus 5 $0.00034 $0.00554
Sonnet 5 $0.00013 $0.00222
Haiku 4.5 $0.00007 $0.00111

Measured 3d ago against content hash 38dea5a5bf2c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

riskmodels-api-discovery scanned grade B with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Sends data to an external URLmediumData exfiltration

A POST to an outside endpoint may be telemetry or may be exfiltration; either way the mod talks to somewhere, and you should know where.

resp = requests.post( "https://riskmodels.app/api/cli/query",

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

resp = requests.post(
.cursor/skills/riskmodels-api-discovery/SKILL.md · 79 lines

How it starts

The opening of the file, as written. The whole thing — 79 lines — stays where its author put it; the contents beside it link to each section on GitHub.

RiskModels API discovery

When to use this skill

Apply before implementing or refactoring:

  • New Python/TypeScript/CLI calls to https://riskmodels.app/api
  • SDK methods in sdk/riskmodels/client.py
  • Example scripts under examples/python/ or packages/riskmodels/examples/
  • Anything that embeds paths, JSON bodies, or query params for the public API

Do not use this skill to answer a stock or portfolio question. Catalog tools (riskmodels_list_endpoints, riskmodels_get_capability, riskmodels_get_schema, riskmodels_get_openapi_spec) are for wiring a client. Live numbers come from riskmodels_decompose, riskmodels_compare, riskmodels_get_returns, or the matching REST routes. After an MCP OAuth connect, call a data tool first — listing endpoints does not count as activation.

Discovery order (mandatory for client work)

1. MCP tools (if connected)

Use the RiskModels MCP server tools exposed in Cursor (names may be prefixed depending on server config; canonical names from mcp/README.md):

Step Tool Purpose
1 riskmodels_list_endpoints Latest index of capabilities: ids, HTTP method, path, short description, cost hints. No arguments. Run this first so you are not working from an outdated mental model.
2 riskmodels_get_capability Full detail for one capability id (parameters, pricing, examples). Input: { "id": "<capability-id>" }.
3 riskmodels_get_schema JSON response schema for an endpoint path. Input: { "path": "/portfolio/risk-snapshot" } (shape per tool schema).

Treat the output of these tools as the provisioning schema for what the API exposes and how it bills—prefer them over remembered URLs when the server is available.

2. Repo sources (always)

Regardless of MCP:

  • OPENAPI_SPEC.yaml — canonical REST contract at repo root.
  • mcp/data/openapi.json — JSON mirror used by the MCP server; good for grep and CI.
  • lib/api/schemas.ts — Zod validation for Next.js routes (must stay aligned with OpenAPI).
  • SEMANTIC_ALIASES.md — field names for user-facing tables and the Python SDK.

Read the full file on GitHub · 79 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 79 lines · 67 tokens per session scan B 38dea5a5bf2c

Subscribe to this mod's changes

riskmodels-api-discovery is a skill published in the GitHub repository BlueWaterCorp/RiskModels_API (0 stars, last pushed today), licensed Apache-2.0. It adds 67 tokens to every session and 1,109 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it B with 2 findings (sends data to an external url, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

convex-add

Add a capability to the CURRENT Convex app — consults the served Convex capability catalog for always-current procedures (billing, crons, auth, agent, search, …); falls back to built-in hosting or @convex-dev component search. TRIGGER when the user runs /add, or asks to add hosting/publishing or any backend capability…

openclaw/clawhub · 81 tokens

twitter-reader

Read Twitter/X for financial research using opencli (read-only). Use this skill whenever the user wants to read their Twitter feed, search for financial tweets, view bookmarks, look up user profiles, or gather market sentiment from Twitter/X. Triggers include: "check my feed", "search Twitter for", "show my…

himself65/finance-skills · 161 tokens

chenhao-limit-up

Use when evaluating A-share limit-up (涨停板) setups through Chen Hao's sentiment and momentum lens: market emotion cycles, board strength, follow-through, and short-term aggressive momentum trading.

questflowai/investorskills · 44 tokens

trading-risk-gate

Unified pre-trade safety gate: Ruin check (Law #1), ergodicity audit, and win-rate dominance validation. Absorbs: ergodicity-check, law-of-ruin, win-rate-dominance.

winstonkoh87/Athena-Public · 53 tokens

cwv-optimizer

Diagnose and fix Core Web Vitals issues on AEM Edge Delivery Services pages. Goes deeper than generic CWV advice by understanding EDS-specific performance patterns including the 100KB LCP budget, E-L-D loading phases, block rendering behavior, and third-party script impact. Produces specific fixes for LCP, CLS, and…

adobe/skills · 112 tokens

multi-expert-analyzer

针对通用问题进行多领域专家联合分析, 综合稿产生前必经 fact-checker 与 red-team 两道独立校验。适用场景: 用户提出跨领域或不确定领域的复杂问题, 需要从多个专家角度分别搜证并相互校验后综合成文, 例如该不该买房、该不该跳槽、是否进入某个赛道等。触发关键词: 多角度分析、专家分析、综合分析、多视角、跨领域分析、从不同角度看、深度分析。问题只属于单一明确领域时, 优先使用该领域的专门 skill, 例如纯财务用 finance-core-analysis、纯技术用 software-architect。输出 (全部 markdown 保存到当前项目 markdown/ 目录): (1) 每位专家的中间分析稿…

digoal/blog · 292 tokens