Agent skill

Yida Dingtalk Openapi

by openyida in openyida/openyida

将钉钉开放平台官方服务端 API 转成宜搭 HTTP 连接器动作,并供表单、集成自动化或 YidaCodeCanvas 自定义页面安全调用。负责官方文档核对、DingAuth 账号配置暂停与确定性回读。触发词:钉钉开放平台接口、api.dingtalk.com、x-acs-dingtalk-access-token。

MITAuto-check passedBackend & APIs

Install Yida Dingtalk Openapi

skills CLI
$ npx skills add openyida/openyida --skill yida-dingtalk-openapi -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install openyida/openyida yida-dingtalk-openapi --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/openyida/openyida.git skills-src && mkdir -p .claude/skills && cp -r skills-src/yida-skills/skills/yida-dingtalk-openapi .claude/skills/yida-dingtalk-openapi && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
yida-dingtalk-openapi
GitHub stars
220
Token cost
~898 tokens
SKILL.md length
226 words
Files
3 (incl. references)
Skills in repo
58
Repo updated
First seen
Licence
MIT

At a glance

将钉钉开放平台官方服务端 API 转成宜搭 HTTP 连接器动作,并供表单、集成自动化或 YidaCodeCanvas 自定义页面安全调用。负责官方文档核对、DingAuth 账号配置暂停与确定性回读。触发词:钉钉开放平台接口、api.dingtalk.com、x-acs-dingtalk-access-token。

  • Works in 12 steps: 按 官方文档入口 定位目标接口页;用户给了精确官方 URL 时直接使用。 → 从目标接口页提取… → 按 入参依赖… → …
  • Tasks that involve OpenAPI specifications
  • SKILL.md covers 触发条件, WHEN NOT, 核心原则 and 工作流, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Yida Dingtalk Openapi is an agent skill from openyida/openyida. 将钉钉开放平台官方服务端 API 转成宜搭 HTTP 连接器动作,并供表单、集成自动化或 YidaCodeCanvas 自定义页面安全调用。负责官方文档核对、DingAuth 账号配置暂停与确定性回读。触发词:钉钉开放平台接口、api.dingtalk.com、x-acs-dingtalk-access-token。

Its SKILL.md is about 900 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/api-contract.md` and `references/connector-mapping.md`).

It sits in Backend & APIs, covering OpenAPI specifications. It works with OpenAPI. The repository describes itself as: Your own personal YiDA AI assistant! The licence is MIT.

When your agent uses it

  • Tasks that involve OpenAPI specifications

Example prompts

  • “/yida-dingtalk-openapi”

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

  1. 按 官方文档入口 定位目标接口页;用户给了精确官方 URL 时直接使用。
  2. 从目标接口页提取 method、host、path、path/query/header/body、响应、权限和幂等字段,按 API 契约 生成无密钥契约文件;每个 Action 保存自己的 sourceUrl。
  3. 按 入参依赖 检查每个必填参数的真实语义、固定值和“调用其他接口获取”链接。所有前置接口也必须生成宜搭自定义连接器 Action,通过连接器调用;不得改用 curl、临时脚本或页面直连。依赖值未解析时不得创建或调用主 Action。
  4. 若文档属于事件订阅、Stream/WebSocket 或 HTTP 回调接收,直接说明 OpenYida 不支持并停止。
  5. 创建 DingAuth 连接器;不得传 --app-key / --app-secret。
  6. 创建结果必须满足 readbackVerified=true;CONNECTOR_READBACK_MISMATCH 是阻断错误,即使 list-actions 能看到动作也不得继续。记录数字管理 ID connectorId 和页面运行时内部名…
  7. 执行 list-actions 回读稳定 operationId。
  8. 执行一次 list-connections --json,记录 beforeConnectionIds。
  9. 若没有可确定复用的 ACTIVE 账号,返回授权账号地址 accountManageUrl、连接器详情地址 detailUrl 和建议账号名后暂停;用户打开 accountManageUrl,在宜搭中自行添加授权账号。
  10. 用户只需回复“已配置”,不要回复密钥或账号 ID。再次执行 list-connections --json
  11. 读接口用 connector test --account-id 做真实探针;写接口先展示目标与副作用,用户确认后只调用一次。宜搭 OpenAPI 额外传 --system-token-app ,CLI 只在内存中注入 body.systemToken。HTTP 200…
  12. 不需要 systemToken 的页面调用加载 yida-canvas-data-binding,页面 binding 写 connectorName: "Http_*",Body 传对象。需要 systemToken 时加载…

What it can do on your machine

Read from SKILL.md and the folder at commit 3dd4693. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • open.dingtalk.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Yida Dingtalk Openapi loads about 898 tokens when it runs, and up to ~3k if it reads all its reference files. Until then it costs about 45 tokens; SKILL.md has 226 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~898
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from openyida/openyida at commit 3dd4693, republished under its MIT licence (© openyida). 226 words, ~898 tokens.

Download SKILL.mdSave it as .claude/skills/yida-dingtalk-openapi/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
yida-dingtalk-openapi
description
将钉钉开放平台官方服务端 API 转成宜搭 HTTP 连接器动作,并供表单、集成自动化或 YidaCodeCanvas 自定义页面安全调用。负责官方文档核对、DingAuth 账号配置暂停与确定性回读。触发词:钉钉开放平台接口、api.dingtalk.com、x-acs-dingtalk-access-token。

钉钉开放平台连接器

触发条件

  • 用户给出钉钉开放平台官方接口文档,要求接入宜搭连接器、表单、自动化或 Canvas 页面。
  • 需求包含 api.dingtalk.com、DingAuth 或 x-acs-dingtalk-access-token。

WHEN NOT

  • 普通第三方或自建 HTTP API 使用 yida-connector。
  • 已有连接器且只需从前后端代码提取动作时使用 yida-connector-safe-actions。
  • 只在历史平台 JSX 页面绑定已有连接器数据源时使用 yida-data-source-connectors。

核心原则

  • 只以用户指定的钉钉官方文档为接口契约;页面较多时按本次业务所需接口逐项读取,不复制整站目录。
  • OpenYida 不支持钉钉事件订阅、Stream/WebSocket 或 HTTP 回调接收;遇到此类需求时直接说明不支持并停止,不生成连接器动作。
  • App Key、App Secret、access token 永远不进入聊天、源码、JSON、命令参数或日志。
  • AI 创建连接器和动作;鉴权账号由用户打开 accountManageUrl,在宜搭页面自行配置。
  • 不需要 systemToken 的 Action 可由 Canvas 通过 window.__OPENYIDA_CONNECTOR_API__ 调用。需要 systemToken 的宜搭 OpenAPI 必须改用 yida-integration,由 CLI 在服务端安全绑定;页面源码和 Action 默认值都不保存该凭据。

工作流

  1. 按 官方文档入口 定位目标接口页;用户给了精确官方 URL 时直接使用。
  2. 从目标接口页提取 method、host、path、path/query/header/body、响应、权限和幂等字段,按 API 契约 生成无密钥契约文件;每个 Action 保存自己的 sourceUrl。
  3. 按 入参依赖 检查每个必填参数的真实语义、固定值和“调用其他接口获取”链接。所有前置接口也必须生成宜搭自定义连接器 Action,通过连接器调用;不得改用 curl、临时脚本或页面直连。依赖值未解析时不得创建或调用主 Action。
  4. 若文档属于事件订阅、Stream/WebSocket 或 HTTP 回调接收,直接说明 OpenYida 不支持并停止。
  5. 创建 DingAuth 连接器;不得传 --app-key / --app-secret。
  6. 创建结果必须满足 readbackVerified=true;CONNECTOR_READBACK_MISMATCH 是阻断错误,即使 list-actions 能看到动作也不得继续。记录数字管理 ID connectorId 和页面运行时内部名 connectorName(必须以 Http_ 开头)。
  7. 执行 list-actions 回读稳定 operationId。
  8. 执行一次 list-connections --json,记录 beforeConnectionIds。
  9. 若没有可确定复用的 ACTIVE 账号,返回授权账号地址 accountManageUrl、连接器详情地址 detailUrl 和建议账号名后暂停;用户打开 accountManageUrl,在宜搭中自行添加授权账号。
  10. 用户只需回复“已配置”,不要回复密钥或账号 ID。再次执行 list-connections --json:
  • 恰好新增一个且名称符合预期:使用该账号;
  • 没有新增,但存在唯一同名 ACTIVE 账号:复用;
  • 多个新增、同名不唯一、名称不符或状态非 ACTIVE:停止,展示低敏候选信息,不猜测。
  1. 读接口用 connector test --account-id 做真实探针;写接口先展示目标与副作用,用户确认后只调用一次。宜搭 OpenAPI 额外传 --system-token-app <appType>,CLI 只在内存中注入 body.systemToken。HTTP 200 只表示请求到达;CLI 还必须确认响应契约和钉钉 errcode。
  2. 不需要 systemToken 的页面调用加载 yida-canvas-data-binding,页面 binding 写 connectorName: "Http_*",Body 传对象。需要 systemToken 时加载 yida-integration,创建服务端自动化;嵌套 assignment 使用 Body.userid 等完整路径。发布回读只证明控制面配置,真实触发与业务读回成功后才能报告业务完成。

创建命令

bash
openyida connector create "<名称>" "api.dingtalk.com" \
  --auth "钉钉开放平台验证" \
  --operations .cache/openyida/<任务>/connector/operations.json \
  --json

openyida connector list-actions <connector-id> --json
openyida connector list-connections <connector-id> --json

connector create --json 返回 accountManageUrl 和 detailUrl。添加授权账号时优先把 accountManageUrl 交给用户;detailUrl 用于查看连接器定义。不得要求用户把配置后的 ID 发给 AI;CLI 通过前后两次列表差异自行发现。

完成标准

  • 每个 Action 都有精确官方 sourceUrl,契约字段可追溯且无任何凭据值。
  • 每个必填入参都已解析为用户输入、固定值、页面运行态值或前置 Action 输出;不能只按字段名猜语义。
  • 连接器返回 readbackVerified=true,数字 connectorId 与 Http_* connectorName 均已记录;页面只使用 connectorName。
  • Action Header 均为 required=false,固定 Content-Type 有非空默认值,可选 Header 不保存空默认项。
  • 连接器及动作已回读,账号归属和 ACTIVE 状态已确定。
  • 只读测试返回业务可识别结果;不能仅凭 HTTP 200 宣称完成。
  • 集成自动化发布返回 controlPlaneVerified=true;runtimeVerified=false 时继续执行真实触发与业务读回,不宣称钉钉动作已经完成。
  • Canvas 场景已通过固定平台代理调用,刷新后仍可读取真实数据。
  • 若停在鉴权阶段,明确报告 connectorId、accountManageUrl、detailUrl、建议账号名和暂停原因,不宣称集成完成。

参考

© openyida, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in yida-skills/skills/yida-dingtalk-openapi of openyida/openyida.

  • SKILL.md
  • references/api-contract.md
  • references/connector-mapping.md

Open the folder on GitHubat commit 3dd4693

Compare with similar skills

Yida Dingtalk Openapi next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Yida Dingtalk Openapi compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yida Dingtalk Openapi this skillopenyida/openyida220—~898Automated safety check: PassMIT
ToolJet Marketplace Plugin BuilderToolJet/ToolJet41k—~2.1kAutomated safety check: PassAGPL-3.0
Step Partsearthtojake/text-to-cad18k1 repos~1.5kAutomated safety check: PassMIT
API DesignerJeffallan/claude-skills12k2 repos~2kAutomated safety check: PassMIT
OpenAPI to MCP Servermcp-use/mcp-use11k—~5.2kAutomated safety check: PassApache-2.0
Use Yaakmountain-loop/yaak19k—~1.9kAutomated safety check: PassMIT

Similar skills

  • Turns an API description, such as an OpenAPI file or a Postman collection, into a connector plugin for ToolJet's marketplace and checks it with the repo's validator.

    41k GitHub stars~2.1k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Step Parts

    earthtojake/text-to-cad

    Find, evaluate, and download common purchasable CAD parts from step.parts, including named off-the-shelf actuators, servos, motors, electronics boards, connectors, screws, bolts, nuts, washers…

    18k GitHub starsUsed in 1 repo~1.5k tokens
    Backend & APIsAuto-check passed
  • API Designer

    Jeffallan/claude-skills

    Designs REST and GraphQL APIs from resource modeling to an OpenAPI 3.1 contract, with versioning, pagination and RFC 7807 error handling.

    12k GitHub starsUsed in 2 repos~2k tokens
    Backend & APIsAuto-check passed
  • OpenAPI to MCP Server

    mcp-use/mcp-use

    Turns an OpenAPI or Swagger spec into an MCP server with the mcp-use TypeScript SDK, mapping each operation to a tool, wiring auth, testing and deploying.

    11k GitHub stars~5.2k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Use Yaak

    mountain-loop/yaak

    A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…

    19k GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Old Coder API Design

    AmazingAng/old-coder

    Reviews or designs an HTTP/JSON API's endpoints, auth, pagination, versioning and deprecations, guarding against inventing a bespoke interface or silently breaking consumers.

    749 GitHub starsUsed in 1 repo~3.4k tokens
    Backend & APIsAuto-check passed

More from openyida/openyida

All 58 skills in this repo
  • Yida Canvas Custom Page

    openyida/openyida

    宜搭自定义页面开发规范,使用 YidaCodeCanvas 组件实现现代 React18 自定义页面。用于官网、看板、工作台、列表、详情、门户壳、可视化、hooks 交互、表单入口,以及需要门户组件、数据管理视图、成员、部门或上传组件的场景;发布层自动注入 yida/utils window 桥。

    220 GitHub stars~4.3k tokensUpdated 7 days ago
    Auto-check passed
  • Openyida Release

    openyida/openyida

    快速发布 OpenYida npm 正式版或测试版。用户说“发布正式版”“发布测试版”“发 beta”或要求按当天日期生成版本 tag 时使用;不用于宜搭应用或自定义页面发布。

    220 GitHub stars~520 tokensUpdated 7 days ago
    Auto-check passed
  • Yida Design Plan

    openyida/openyida

    Plan 模式的视觉设计分支。基于需求选择视觉方向,再结合业务页面规划维护 build-plan.json 的 visualStyle,供 CLI 派生 design.md。

    220 GitHub stars~756 tokensUpdated 7 days ago
    Auto-check passed
  • Prevent stale local OpenYida custom page source from overwriting live designer edits.

    220 GitHub stars~1.2k tokensUpdated 7 days ago
    Auto-check passed
  • Codemap

    openyida/openyida

    Generate, update, or drift-check agent-facing CodeMaps as progressive code terrain indexes for projects, features, capabilities, functions, modules, or bug chains.

    220 GitHub stars~1k tokensUpdated 7 days ago
    Auto-check passed
  • Sdd Riper One Light

    openyida/openyida

    面向 GPT-5.5 等强模型和熟练用户的轻量 AI Agent Harness / checkpoint-driven coding skill。默认用户已经把任务切到基本可执行的最小混沌单元;模型自行分解、探索与推进,人类通过最终目标、最小 spec、复述、checkpoint、证据验证与回写来低干扰控盘。

    220 GitHub stars~1.5k tokensUpdated 7 days ago
    Auto-check passed

Works with

Categories

Questions about Yida Dingtalk Openapi

What does Yida Dingtalk Openapi do?

将钉钉开放平台官方服务端 API 转成宜搭 HTTP 连接器动作,并供表单、集成自动化或 YidaCodeCanvas 自定义页面安全调用。负责官方文档核对、DingAuth 账号配置暂停与确定性回读。触发词:钉钉开放平台接口、api.dingtalk.com、x-acs-dingtalk-access-token。. Yida Dingtalk Openapi is an agent skill from openyida/openyida.

When should I use Yida Dingtalk Openapi?

Yida Dingtalk Openapi fits situations like: tasks that involve OpenAPI specifications.

How do I install Yida Dingtalk Openapi in Claude Code?

Run `npx skills add openyida/openyida --skill yida-dingtalk-openapi -a claude-code`. Or copy the skill folder (yida-skills/skills/yida-dingtalk-openapi in openyida/openyida) into .claude/skills/yida-dingtalk-openapi in your project. Claude Code loads it when a task matches its description.

How do I install Yida Dingtalk Openapi in Codex?

Run `npx skills add openyida/openyida --skill yida-dingtalk-openapi -a codex`. Or copy the skill folder (yida-skills/skills/yida-dingtalk-openapi in openyida/openyida) into .agents/skills/yida-dingtalk-openapi in your project. Codex loads it when a task matches its description.

Can I use Yida Dingtalk Openapi in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add openyida/openyida --skill yida-dingtalk-openapi -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/yida-dingtalk-openapi, .gemini/skills/yida-dingtalk-openapi, .github/skills/yida-dingtalk-openapi and .opencode/skills/yida-dingtalk-openapi in your project.

What does Yida Dingtalk Openapi need to run?

SKILL.md names no scripts, command-line tools or credentials: Yida Dingtalk Openapi is instructions for the agent only.

Does Yida Dingtalk Openapi access the network?

SKILL.md names 1 domain. As links in the text: open.dingtalk.com. This is read from the text; nothing was executed.

Is Yida Dingtalk Openapi safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Yida Dingtalk Openapi use?

Yida Dingtalk Openapi is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Yida Dingtalk Openapi use?

About 898 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Yida Dingtalk Openapi?

Skills that share tags, products or a category with Yida Dingtalk Openapi: ToolJet Marketplace Plugin Builder (ToolJet/ToolJet, 41k stars), Step Parts (earthtojake/text-to-cad, 18k stars), API Designer (Jeffallan/claude-skills, 12k stars) and OpenAPI to MCP Server (mcp-use/mcp-use, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yida Dingtalk Openapi?

openyida (a GitHub organization) maintains it in openyida/openyida, which has 220 GitHub stars. The repository holds 58 skills in this directory. The repository was last updated on September 30, 2026.

Source: openyida/openyida on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.