yida-connector

yida-connector is a skill for Claude Code, Codex from openyida/openyida. It costs 60 tokens per session (2,520 once invoked), scanned A, original, MIT.

A tool for creating and managing Yida HTTP connectors, which let Yida call external services and APIs. It supports several ways to authenticate those requests.

In plain words
What is it for?
Use it to connect Yida to DingTalk, internal systems, or third-party APIs, configure authentication, and create or update connector actions from API request details.
Why use it?
It keeps API credentials in connector settings instead of hard-coding them in page code. It also helps identify valid connector and action IDs and handles common connection errors.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to connect Yida to DingTalk, internal systems, or third-party APIs, configure authentication, and create or update connector actions from API request details.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/openyida/openyida/yida-connector
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.

Any agent
npx skills add openyida/openyida --skill yida-connector
Clone the repo
git clone --depth 1 https://github.com/openyida/openyida

Made for: Claude Code, Codex.

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 yida-connector

README.md
[![agentmods](https://agentmods.dev/badge/skills/openyida/openyida/yida-connector.svg)](https://agentmods.dev/skills/openyida/openyida/yida-connector)
Your own site
<a href="https://agentmods.dev/skills/openyida/openyida/yida-connector"><img src="https://agentmods.dev/badge/skills/openyida/openyida/yida-connector.svg" alt="Measured on agentmods" height="20"></a>
Per session 60 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,520 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Data Exfiltration · line 139
    Data is being sent to an external URL. This could be legitimate telemetry or data exfiltration. Manual review is recommended.
    Fix: Verify the destination URL is trusted and necessary. Remove or replace with documented APIs. Ensure no secrets, tokens, or PII are transmitted.
How audits are shown
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.1 $0.00060 $0.02520
Opus 5 $0.00030 $0.01260
Sonnet 5 $0.00012 $0.00504
Haiku 4.5 $0.00006 $0.00252

Measured today against content hash d1a43cf4efd6, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

yida-connector scanned grade A with 1 finding 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 today.

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.

Makes network callslowCapability

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

- 优先使用 `smart-create` 从 curl 命令生成脱敏动作草稿;它不创建或更新远端连接器,后续创建/追加仍需显式执行对应命令
yida-skills/skills/yida-connector/SKILL.md · 180 lines

How it starts

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

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 listlist-actions 获取有效 ID,不得编造
权限不足 / 登录态失效 停止执行,提示用户执行 openyida auth status 检查登录态
鉴权配置错误 停止执行,引导用户检查鉴权方式和凭证配置
智能创建解析失败 降级为模板创建方式,引导用户使用 gen-template
网络超时 重试 1 次,仍失败则停止并提示用户检查网络
用户要求删除连接器 明确说明 CLI 不执行删除;仅查询目标并展示平台手工删除指引,不得宣称命令已删除资源
未知错误 停止执行,完整展示错误信息,建议用户反馈问题

鉴权方式

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

Read the full file on GitHub · 180 lines

Files

What ships with it

7 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. today Changed · +7 lines d1a43cf4efd6
  2. 8d ago First seen · 173 lines · 60 tokens per session scan A 3c9d7f1d2058

Subscribe to this mod's changes

yida-connector is a skill published in the GitHub repository openyida/openyida (210 stars, last pushed today), licensed MIT. It adds 60 tokens to every session and 2,520 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

new

Create a new project to start development quickly.

clacky-ai/openclacky · 10 tokens

channel-manager

Configure IM platform channels (Feishu, WeCom, Weixin, Discord, Telegram, DingTalk) for openclacky. Uses browser automation for navigation; guides the user to paste credentials and perform UI steps. Trigger on: "channel setup", "setup feishu", "setup wecom", "setup weixin", "setup wechat", "setup discord", "setup…

clacky-ai/openclacky · 175 tokens

webflow-mcp:cms-best-practices

Expert guidance on Webflow CMS architecture and best practices. Use when planning collections, setting up relationships, optimizing content structure, or troubleshooting CMS issues.

webflow/webflow-skills · 40 tokens

webflow-mcp:cms-collection-setup

Create a new CMS collection in Webflow with specified fields and relationships. Use when setting up blog posts, products, team members, portfolios, or other content types with custom fields.

webflow/webflow-skills · 47 tokens

a0-development

Development guide for extending Agent Zero from current source and DOX. Use for framework architecture, tools, extensions, API/WebUI handlers, agent profiles, prompts, skills, projects, runtime boundaries, and contribution workflow. Load the focused reference files before giving implementation guidance.

agent0ai/agent-zero · 57 tokens

doris-debug-deployment

Use for Doris FE/BE startup failures, port conflicts, prioritynetworks misrouting, metadir corruption, and ADD/DROP BACKEND issues.

apache/doris-skills · 36 tokens