cue-skills
English · 中文
Open-source agent skills published by Cue (sensedeal).
A skill is a portable instruction bundle that any AI agent (Claude Code, Codex CLI, Gemini CLI, …) can load to gain a new capability — without modifying the agent itself. This repo collects the skills Cue maintains for public use.
New here? Read Why Cue · 中文 — source-cited research you can verify, and how to try it free.
Install
npx skills add sensedeal/cue-skills # default: lists cue-buddy, cue-research, cue-omni-reader, cue-data-mcp
npx skills add sensedeal/cue-skills --skill cue-research # add one skill
See Using a skill for manual install and per-skill notes. DSH users: jump to DSH bundles.
DSH users: install the Cue Deep Research bundles
Running DeepSeek Harness? Add the three Cue bundles to a profile and get Cue as native mcp__omni__* (parse/read) and mcp__cue_* (financial/regulatory data) tools:
dsh plugin --profile web add @cueai/dsh-omni-reader # Omni Reader parse/read tools
dsh plugin --profile web add @cueai/dsh-omni-reader-guard # optional SSRF/consent guard
dsh plugin --profile web add @cueai/dsh-cue-data-mcp # Cue public data MCP (15 domains / ~104 tools)
Restart dsh; the model then sees mcp__omni__parse / …get_parse_status / …read_result / …read_outline / …save_result / …cancel_parse / …discard_result and mcp__cue_<domain>__* data tools. Set CUE_API_KEY (+ optional OMNI_ALLOWED_ROOTS) via $DSH_HOME/.env. Guide: dsh/ · usage.md.
DSH bundles
This repo also ships DeepSeek Harness bundles under dsh/ — thin composition packages that wire a Cue MCP server into a DSH profile so its tools surface natively (e.g. mcp__omni__parse). A skill is agent-loadable instructions; a bundle is a composition package (package.json + cordis.patch.yml) for the Harness. Install one with dsh plugin --profile web add <pkg>; see dsh/README.md and the cue-omni-reader bundle.
Repo-root bundle
The repository root is itself a DSH bundle (package.json declaring dsh.bundle.patch → cordis.patch.yml), so one command wires the whole Cue surface — the Omni Reader MCP server plus the Cue public data domains — into a profile:
dsh plugin --profile web add github:sensedeal/cue-skills#<commit>
Registries that install a repository as a DSH bundle (for example skillhub.cn) accept a repo only when this root manifest exists; the per-capability bundles under dsh/ stay available for narrower installs, and the optional SSRF/consent guard is deliberately not part of the repo-root bundle because it fails closed on local files.
Skills in this repo
| Skill | Purpose | Status |
|---|
cue-buddy/ — cue-buddy | Lets business experts author, validate, test, tune, and pin-as-frequent Cue "buddy" research templates via natural conversation. No Python / API knowledge needed; the agent talks to the Cue production API on the user's behalf. | v0.3.8 |
cue-research/ — cue-research | Sibling to cue-buddy for using Cue from inside your AI agent: ask a question → skill matches ≤2 candidate buddies (or routes to free-form deep research via /api/rewrite) → you confirm credits → it runs in the background and retrieves the report via replay → on satisfaction you can distill a free-form run into a saved buddy via cue-buddy. Supports 仿写/mimic (imitate a reference URL or sample document's writing style). | v0.3.8 |
cue-omni-reader/ — cue-omni-reader | Helps external agents parse HTTP(S) URLs and authorized local documents, audio, or video through the official MCP tools, including safe Bridge bootstrap, recoverable operations, deliberate inline/artifact delivery, outline navigation, complete result reading, and cleanup. Thin instruction layer; no custom parser or protocol driver. | v0.5.7 |
cue-data-mcp/ — cue-data-mcp | Lets external agents query Cue's public MCP data services (regulatory, macro, disclosures, market data, legal full text, holdings, entity data, academic, IPO, ESOP, buyback, footnote details) by discovering live domains from the anonymous /api/mcp-catalog and connecting through each domain's routing DTO. Thin instruction layer; no hardcoded endpoints or tool names. | v0.3.6 |
| — |
More skills will be added here as Cue's surface grows.
What is Cue / What is a buddy
Cue is a Deep Research Agent + Intelligence Sentinel platform for high-precision finance and business workflows. It picks tools from 300+ professional data sources (A-share / HK / US equity disclosures, fund AMAC registries, business registries, court records, regulatory feeds, sell-side research, capital flow data), cross-validates findings across sources, and produces structured, source-cited reports in minutes instead of hours.
A "buddy" (搭子) is a research playbook for a specific scenario — corporate-credit pre-diligence, public-record compliance snapshot, quarterly earnings review, private-fund manager DD, etc. — defined once and reused by supplying the subject. The cue-buddy skill in this repo is what business experts use to author these playbooks conversationally.
Scope boundary: Cue's tool surface covers public data sources only (equity disclosures / business registries / court records / regulatory filings / capital flows / etc.). Scenarios requiring private data (real AML on bank-internal transactions, medical diagnosis, internal accounting) are not appropriate as Cue buddies — the supervisor cannot route them and falls back to generic web search. cue-buddy +author flow calls +capabilities to cross-check each declared evidence source against the actual catalog before persisting a template.
See cue-buddy/README.md for the full skill walkthrough.
Using a skill
cue-buddy is self-contained: an entrypoint SKILL.md, supporting references/, and stdlib-only scripts/. cue-research is self-contained too — it vendors the shared Cue client (cue_api / sse_report / paths) in its own scripts/, so it runs standalone (no sibling cue-buddy required).
Preferred install is at the top of this README (npx skills add). The skills CLI lists every skill; --skill picks one.
Manual install: copy the skill folder into ~/.claude/skills/ (Claude Code) or reference it via /use-skill <path>; other agents load <skill>/SKILL.md as a system instruction. Each skill is self-contained — cue-buddy/cue-research vendor their runtime, cue-omni-reader/cue-data-mcp are thin instruction layers.
cue-omni-reader ships no runtime parser scripts. Load its SKILL.md and connect an official Omni MCP surface. Existing URL tools need no local install; local files use the audited Bridge after minimum-root confirmation.
cue-data-mcp ships no runtime code. Load its SKILL.md and let the agent discover the live data domains from the anonymous /api/mcp-catalog, then connect through each domain's routing DTO. Self-contained: no sibling folders required.
The playbook/ scene skills delegate the actual research run to cue-research's runner. cue-research is self-contained (it vendors the shared Cue client), so install playbook/<scene> + cue-research as siblings under the same parent dir; cue-buddy is only needed if you also want to author or save buddies.
Credit grant to start: every Cue account gets 500 credits on signup, plus 10 more each day. Once you apply for an API key (sign in via the cue CLI) you can start — data queries and initial research draw from this grant, and each deep-research run still consumes credits, so the skills always confirm with you before spending.
Contributing
Bug reports and skill suggestions: open an issue.
Pull requests welcome. Each skill has its own hard-rules / validator; see the skill's README for contribution guidelines.
License
MIT — see LICENSE. Skill content is free to use, modify, and redistribute.
