Agent skill

Yida Connector

by openyida in openyida/openyida

宜搭 HTTP 连接器创建与管理。打通钉钉/自建系统/第三方 API,支持 6 种鉴权方式。适用于用户需要接入外部接口、配置鉴权、创建或管理连接器时。

MITAuto-check passedBackend & APIs

Install Yida Connector

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

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

GitHub CLI
$ gh skill install openyida/openyida yida-connector --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-connector .claude/skills/yida-connector && 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-connector
GitHub stars
220
Token cost
~1.4k tokens
SKILL.md length
303 words
Files
8 (incl. references)
Skills in repo
58
Repo updated
First seen
Licence
MIT

At a glance

宜搭 HTTP 连接器创建与管理。打通钉钉/自建系统/第三方 API,支持 6 种鉴权方式。适用于用户需要接入外部接口、配置鉴权、创建或管理连接器时。

  • Tasks that involve REST APIs
  • SKILL.md covers 严格禁止 (NEVER DO), 严格要求 (MUST DO), 适用场景 and 触发条件, plus 9 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Yida Connector is an agent skill from openyida/openyida. 宜搭 HTTP 连接器创建与管理。打通钉钉/自建系统/第三方 API,支持 6 种鉴权方式。适用于用户需要接入外部接口、配置鉴权、创建或管理连接器时。

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including reference files (for example `examples/operations-device-alarm.json`, `examples/operations-search-formdata-v2.json` and `examples/operations-search-formdata.json`).

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

When your agent uses it

  • Tasks that involve REST APIs

Example prompts

  • “/yida-connector”

What it can do on your machine

Read from SKILL.md and the folder at commit b52e65e. 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):

    • docs.aliwork.com
    • 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 Connector loads about 1.4k tokens when it runs, and up to ~2.8k if it reads all its reference files. Until then it costs about 23 tokens; SKILL.md has 303 words of instructions outside code blocks.

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

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 b52e65e, republished under its MIT licence (© openyida). 303 words, ~1,427 tokens.

Download SKILL.mdSave it as .claude/skills/yida-connector/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
yida-connector
description
宜搭 HTTP 连接器创建与管理。打通钉钉/自建系统/第三方 API,支持 6 种鉴权方式。适用于用户需要接入外部接口、配置鉴权、创建或管理连接器时。

HTTP 连接器管理

严格禁止 (NEVER DO)

  • 不要要求用户在聊天中发送 API Key、密码、App Key、App Secret;也不要把凭据放进源码、JSON 或命令参数
  • 不要编造 connector-id 或 action-id,必须从命令返回中提取
  • 不要把 connector delete 当作真实删除命令;CLI 仅查询目标并展示平台手工删除指引
  • 不要用 shell heredoc、cat/echo/printf/tee 或重定向生成连接器 action/config JSON

严格要求 (MUST DO)

  • 优先使用 smart-create 从 curl 命令生成脱敏动作草稿;它不创建或更新远端连接器,后续创建/追加仍需显式执行对应命令
  • 创建连接器后,将 connector-id 记录到 .cache/<项目名>-schema.json
  • 同时记录 connectorName。数字 connectorId 只用于 CLI 管理;自定义页面调用网关必须使用以 Http_ 开头的 connectorName
  • --operations、--action 等文件参数必须先用结构化文件写入工具创建到 <projectRoot>/.cache/openyida/<项目名或任务名>/connector/ 或该技能更具体的目录,再传给命令;不要写仓库根目录或系统临时目录
  • 本技能不读写 memory:连接器配置通过 CLI 命令写入宜搭平台,不依赖跨会话的 memory 状态

适用场景

用户需要"接入外部接口"、"调用第三方 API"、"HTTP 连接器"时使用。钉钉官方 OpenAPI 使用 yida-dingtalk-openapi,由它再调用本技能。

触发条件

正向触发:

  • "接入外部接口"、"调用第三方 API"
  • "HTTP 连接器"
  • "打通自建系统"、"API 集成"
  • "配置鉴权"、"创建连接器"

危险操作确认

CLI 不执行连接器删除。用户确需删除时,先确认并解除表单、页面、流程和集成自动化中的全部依赖,再根据命令指引前往宜搭平台管理后台手工删除;平台删除不可逆。

异常处理

异常场景处理方式
连接器不存在(connector-id 无效)重新执行 openyida connector list 获取有效 ID,不得编造
鉴权失败(401/403)检查鉴权方式和凭证配置,重新创建连接器或更新鉴权账号
API 调用超时检查目标域名是否可达,确认网络连通性后重试
action-id 不存在执行 openyida connector list-actions <connector-id> 重新获取有效 action-id
需要删除连接器执行 openyida connector delete <connector-id> --force 仅查询目标并获取平台指引;确认并解除全部依赖后,在宜搭平台管理后台手工删除
智能创建解析失败改用 openyida connector gen-template 生成模板,手动填写后再创建

Agent 错误处理策略

当 Agent 执行本技能遇到错误时,必须遵循以下默认行为:

错误类型默认处理策略
命令执行失败停止执行,向用户展示错误信息,询问是否重试或调整参数
参数缺失(connector-id/action-id 等)执行 connector list 或 list-actions 获取有效 ID,不得编造
权限不足 / 登录态失效停止执行,提示用户执行 openyida auth status 检查登录态
鉴权配置错误停止执行,引导用户检查鉴权方式和凭证配置
智能创建解析失败降级为模板创建方式,引导用户使用 gen-template
网络超时重试 1 次,仍失败则停止并提示用户检查网络
用户要求删除连接器明确说明 CLI 不执行删除;仅查询目标并展示平台手工删除指引,不得宣称命令已删除资源
未知错误停止执行,完整展示错误信息,建议用户反馈问题

鉴权方式

界面显示内部类型适用场景
无身份验证NONE公开 API
基本身份验证BasicAuth用户名密码
API 密钥ApiKeyAuthHeader/Query 传密钥
钉钉开放平台验证DingAuth钉钉 OpenAPI
阿里云 API 网关AliyunApiGateway阿里云网关
钉钉零信任网关DingTrustGW零信任网关

命令

连接器管理
bash
# 列出所有连接器
openyida connector list

# 创建连接器
openyida connector create "<名称>" "<域名>" --operations <action-file> [--auth "<鉴权方式>"]

# 获取详情
openyida connector detail <connector-id>

# 查询连接器并获取平台手工删除指引(CLI 不执行删除)
openyida connector delete <connector-id> --force
执行动作管理
bash
# 列出执行动作
openyida connector list-actions <connector-id>

# 添加执行动作(智能匹配已有连接器)
openyida connector add-action --operations <action-file> --host <域名>

# 仅更新已有动作中已声明的 Query 默认值
openyida connector update-action --connector-id <id> --action <operationId> \
  --query-json '{"currentPage":"1"}' --confirm

# 删除执行动作
openyida connector delete-action <connector-id> <action-id>

# 测试连接器(--action 必须是稳定的 operationId)
openyida connector test --connector-id <id> --action <operationId> \
  --path-json '{"id":"42"}' \
  --query-json '{"page":1}' \
  --header-json '{"X-Trace":"owned"}' \
  --body-json '{"name":"Ada"}'

--params 仍兼容旧调用,但每个字段只会按动作 Schema 分发到 path/query/header/body;未知或位置冲突字段会停止执行。需要鉴权时必须传属于当前连接器的 --account-id。只有 canonical statusLine 为 2xx 才算测试成功;测试前后可用 list-actions 确认动作未被修改。

add-action 只允许追加新稳定 ID,发现既有 operationId 或 id 冲突时停止,不覆盖。编辑已有动作时使用 update-action;它只接受非空 --query-json,要求 Query 在 inputs 与 parameters 中各自唯一且可回读,完整集合 replace-all 后必须证明连接器非目标 fingerprint、动作数量、其他动作和稳定 ID 不变。写入结果 unknown 时不自动重试。

connector create/add-action 返回 CONNECTOR_READBACK_MISMATCH 时必须停止。动作已经存在不代表配置正确;按错误中的 firstDifference 和 nextStep 检查,不得继续生成页面或调用该动作。

鉴权账号管理
bash
openyida connector list-connections <connector-id> --json

需要密钥的连接器创建完成后,把 connector create --json 返回的 accountManageUrl 交给用户,引导用户在宜搭页面自行添加授权账号;detailUrl 只用于查看连接器定义。用户只回复“已配置”,Agent 用配置前后的 list-connections --json 差异确定账号。不得要求用户回传凭据或账号 ID;多个候选时停止,不猜测。

智能生成动作草稿(推荐)
bash
# 从 curl 命令生成脱敏草稿(不创建远端资源)
openyida connector smart-create --curl "curl 'https://api.example.com/v1/data' -H 'Authorization: Bearer xxx'" --name "<连接器名>"

# 解析接口文档
openyida connector parse-api --doc ./api-doc.md

# 生成接口文档模板
openyida connector gen-template

创建示例

bash
# 无鉴权
openyida connector create "测试API" "api.example.com"

# 基本身份验证
openyida connector create "内部系统" "internal.company.com" --auth "基本身份验证" --username admin --password 123456

# 钉钉开放平台(凭据后续由用户自行配置)
openyida connector create "钉钉API" "api.dingtalk.com" --auth "钉钉开放平台验证" --operations ./operations.json --json

执行动作配置

详见 连接器执行动作配置文件格式。

  • id 使用稳定的 operation-<operationId>,同一接口重复生成不得随时间变化。
  • 同一批动作中的 operationId 必须唯一;重复时停止保存,不覆盖或猜测选择。
  • Authorization、Cookie、token、API Key 等敏感 Header 的示例值不得序列化进 action,统一保留空默认值并通过鉴权账号在运行时注入。
  • Header 分组及其子字段统一保存为 required=false,规避平台运行时把已传值误判为空。Content-Type 作为非空固定默认值保留;可选 Header 没有默认值时不写入 parameters.header。业务真正必填的 Header 由调用方在执行前检查并传入。
  • 宜搭 OpenAPI 的 systemToken 字段保留空默认值。真实测试使用 connector test ... --system-token-app <appType>;业务调用使用 yida-integration 的服务端安全绑定。普通 --params、--body-json、--connector-assignment 和 Action 文件均不得携带该值。
  • Canvas 调用的 inputs.body 必须是对象,不能传 JSON.stringify(...) 的字符串。

模板

  • 接口文档模板:帮助用户填写接口信息以创建连接器,可通过 openyida connector gen-template 命令生成

参考文档

© 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 7 other files (references) in yida-skills/skills/yida-connector of openyida/openyida.

  • SKILL.md
  • examples/operations-device-alarm.json
  • examples/operations-search-formdata-v2.json
  • examples/operations-search-formdata.json
  • examples/operations-teambition.json
  • examples/operations-yida-attachment.json
  • references/connector-action-format.md
  • templates/api-document-template.md

Open the folder on GitHubat commit b52e65e

Compare with similar skills

Yida Connector 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 Connector compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yida Connector this skillopenyida/openyida220—~1.4kAutomated safety check: PassMIT
Paperclippaperclipai/paperclip99k—~9.6kAutomated safety check: PassMIT
Nodejs Backend Patternsever-works/ever-works16218 repos~4kAutomated safety check: PassAGPL-3.0
OpenAPI to MCP Servermcp-use/mcp-use11k—~5.2kAutomated safety check: PassApache-2.0
Use Yaakmountain-loop/yaak19k—~1.9kAutomated safety check: PassMIT
API DesignerJeffallan/claude-skills12k1 repos~2kAutomated safety check: PassMIT

Similar skills

  • Paperclip

    paperclipai/paperclip

    Interact with the Paperclip control plane API for task coordination and governance.

    99k GitHub stars~9.6k tokensUpdated today
    Backend & APIsAuto-check passed
  • Nodejs Backend Patterns

    ever-works/ever-works

    Build production-ready Node.js backend services with Express/Fastify, implementing middleware patterns, error handling, authentication, database integration, and API design best practices.

    162 GitHub starsUsed in 18 repos~4k 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 today
    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 3 days ago
    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 1 repo~2k tokens
    Backend & APIsAuto-check passed
  • Covers the RuView `wifi-densepose` command line binary, its Axum REST API and the WebAssembly builds for browsers and ESP32, for embedding or scripting RuView.

    97k GitHub stars~1.2k tokensUpdated today
    Backend & APIsAuto-check: notes

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 yesterday
    Auto-check passed
  • Openyida Release

    openyida/openyida

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

    220 GitHub stars~520 tokensUpdated yesterday
    Auto-check passed
  • Yida Design Plan

    openyida/openyida

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

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

    220 GitHub stars~1.2k tokensUpdated yesterday
    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 yesterday
    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 yesterday
    Auto-check passed

Categories

Questions about Yida Connector

What does Yida Connector do?

宜搭 HTTP 连接器创建与管理。打通钉钉/自建系统/第三方 API,支持 6 种鉴权方式。适用于用户需要接入外部接口、配置鉴权、创建或管理连接器时。. Yida Connector is an agent skill from openyida/openyida.

When should I use Yida Connector?

Yida Connector fits situations like: tasks that involve REST APIs.

How do I install Yida Connector in Claude Code?

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

How do I install Yida Connector in Codex?

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

Can I use Yida Connector 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-connector -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-connector, .gemini/skills/yida-connector, .github/skills/yida-connector and .opencode/skills/yida-connector in your project.

What does Yida Connector need to run?

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

Does Yida Connector access the network?

SKILL.md names 2 domains. As links in the text: docs.aliwork.com and open.dingtalk.com. This is read from the text; nothing was executed.

Is Yida Connector 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 Connector use?

Yida Connector 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 Connector use?

About 1.4k tokens (SKILL.md is roughly 5.7k 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 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Yida Connector?

Skills that share tags, products or a category with Yida Connector: Paperclip (paperclipai/paperclip, 99k stars), Nodejs Backend Patterns (ever-works/ever-works, 162 stars), OpenAPI to MCP Server (mcp-use/mcp-use, 11k stars) and Use Yaak (mountain-loop/yaak, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yida Connector?

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 October 8, 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.