yolo-query SKILL.md skillA
yolo-query from xiaour/yolo-data is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add xiaour/yolo-data/yolo-query@git:20261017.6fa51dbPins git:20261017.6fa51db in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- xiaour/yolo-data
- Path
mcp-connector/skills/yolo-query/SKILL.md- Versions recorded
- 2
- Latest version
- git:20261017.6fa51db, committed Oct 17, 2026
- First version recorded
- Oct 15, 2026
- Size
- 2,389 bytes
- Repository stars
- 64
- License
- Apache-2.0
通过 YOLO Data 的 MCP 服务查询主题指标与数据集。当用户想「查询某主题下的指标」「问数平台有哪些指标」「按指标出数」「拉取问数结果」且已配置 mcp_ 开头的 API Key 与 /mcp 端点时使用。触发词：YOLO Data、问数平台、指标查询、MCP 查询。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# YOLO Data 问数技能（MCP 客户端侧）
经由 MCP `streamable-http` 端点 `/mcp` 调用 YOLO Data 智能问数平台的 5 个工具。
鉴权为 Bearer API Key（形如 `mcp_xxxx`），由平台管理员在后台 `POST /admin/mcp/keys` 创建。
## 前置条件
- 已拿到 `mcp_` 开头的 API Key。
- 已知目标 `userId` 与 `themeId`（主题名称与可用范围由平台配置提供）。
- 端点通常为 `https://<host>/mcp`，客户端 transport 头带 `Authorization: Bearer <key>`。
## 标准工作流
1. **发现指标**：调用 `list_metrics({ userId, themeId, keyword? })`，确认有哪些可问指标及其 `bizName`。
2. **确认权限**（可选）：调用 `get_policy({ userId, themeId })` 查看可问范围与行/列策略。
3. **编译契约**：调用 `resolve_query`，传入 `sourceType`（`INDICATOR` 用 `indicatorId`；`BUSINESS_DATASET` 用 `datasetId`）、`metrics`、`dimensions?`、`filters?`、`dateInfo?`、`timeGrain?`。返回 `contractId`（24h 有效）。
4. **执行契约**：调用 `execute_query({ contractId })` 取结果。同一 `contractId` 多次执行结果一致（确定性，不触发 LLM）。
5. **取历史产物**（可选）：调用 `get_snapshot({ artifactId, userId })` 读取已落库的分析产物预览。
## 关键约束
- `resolve_query` 必须先于 `execute_query`：未先编译则 `execute_query` 报 `CONTRACT_NOT_FOUND(-32010)`。
- 契约过期（默认 24h）报 `CONTRACT_EXPIRED(-32011)`，需重新 `resolve_query`。
- 平台门禁（review）未通过的指标/维度组合会直接报错，按错误信息调整参数。
- 字段口径：指标的 `metrics`/`dimensions` 用 `list_metrics` 返回的 `bizName`；数据集同理用数据集字段业务名。
## 错误处理
- `401`：API Key 缺失/无效 → 检查 `mcp_` 前缀与是否过期吊销。
…Read the whole file at its exact version.
How to install
mdr add xiaour/yolo-data/yolo-query@sha256:77c7c418ba6d6afbThe line at the top of this page pins the label git:20261017.6fa51db, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_4q5tz6acw736wvgs)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Oct 15, 2026 and Oct 17, 2026, about one every 2 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261017.6fa51db latest | 2026-10-17 | 6fa51db | 2,389 B | A | view · diff |
| git:20261015.8b9d9c4 | 2026-10-15 | 8b9d9c4 | 2,384 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (2389 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
xiaour/yolo-data · 64 stars · license Apache-2.0 · pushed 2026-11-06 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_4q5tz6acw736wvgs GET https://markdownregistry.com/api/v1/resolve?ref=xiaour/yolo-data/yolo-query GET https://markdownregistry.com/api/v1/blob/77c7c418ba6d6afbce2d8ec528478ab551ce740a7e0bd177bdf69a8b44dc0bb6
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.