Agent skill

Yida Create App

by openyida in openyida/openyida

创建宜搭应用并返回 appType;仅当没有目标 app 且用户意图允许新建时使用. An agent skill from openyida/openyida.

MITAuto-check passed

Install Yida Create App

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

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

GitHub CLI
$ gh skill install openyida/openyida yida-create-app --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-create-app .claude/skills/yida-create-app && 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-create-app
GitHub stars
220
Token cost
~1.7k tokens
SKILL.md length
445 words
Files
1
Skills in repo
58
Repo updated
First seen
Licence
MIT

At a glance

创建宜搭应用并返回 appType;仅当没有目标 app 且用户意图允许新建时使用. An agent skill from openyida/openyida.

  • Works in 3 steps: 根技能或 yida-app 已完成… → 没有从本轮 prompt、应用 URL、已绑定资源上下文、workspace… → 用户明确要求从零创建应用,或完整搭建缺少 app 且…
  • SKILL.md covers Resource-First 使用门槛, 严格禁止 (NEVER DO), 严格要求 (MUST DO) and 适用场景, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Yida Create App is an agent skill from openyida/openyida. 创建宜搭应用并返回 appType;仅当没有目标 app 且用户意图允许新建时使用。

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Your own personal YiDA AI assistant! The licence is MIT.

Example prompts

  • “/yida-create-app”

Requirements

  • Python 3

Workflow steps

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

  1. 根技能或 yida-app 已完成 resolve_resource_context;
  2. 没有从本轮 prompt、应用 URL、已绑定资源上下文、workspace 配置/缓存或会话历史解析到目标 appType;
  3. 用户明确要求从零创建应用,或完整搭建缺少 app 且 allowCreate=true。

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 and json).

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

  • Network

    No URLs in SKILL.md.

    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 Create App loads about 1.7k tokens when it runs. Until then it costs about 15 tokens; SKILL.md has 445 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~15
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

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). 445 words, ~1,744 tokens.

Download SKILL.mdSave it as .claude/skills/yida-create-app/SKILL.md (or your agent's skills folder).
name
yida-create-app
description
创建宜搭应用并返回 appType;仅当没有目标 app 且用户意图允许新建时使用。

创建应用

资源边界:本技能只处理普通 OpenYida 应用创建;目标不明时先只读确认或询问用户。

创建成功结果同时包含 url / appUrl / workbenchUrl(应用工作台)和 adminUrl(开发者管理后台)。完整应用最终交付默认保留 adminUrl,与前台、可选业务后台区分;不因云端登录态省略。地址可生成不等于收件人已获得管理权限。历史结果缺少该字段时可通过 app-list 分页匹配真实 appType 回查。

Resource-First 使用门槛

本技能不是完整搭建的默认第一步,只能在以下条件同时满足时加载/执行:

  1. 根技能或 yida-app 已完成 resolve_resource_context;
  2. 没有从本轮 prompt、应用 URL、已绑定资源上下文、workspace 配置/缓存或会话历史解析到目标 appType;
  3. 用户明确要求从零创建应用,或完整搭建缺少 app 且 allowCreate=true。

若已解析到 appType、应用 URL、已绑定 app 或 workspace 中可确认的 app,必须复用该 app 并继续后续表单/页面/发布步骤,不得调用 openyida create-app。若用户说“新建另一个应用”,先确认目标组织和新应用名,再执行本技能。

若该 app 是外部工具预创建的 app(上下文标记 source=agent_bound 或 precreated=true),也仍然视为“已有目标 app”:不得调用 openyida create-app,也不得在本技能中修改应用名称。本技能只负责在确实没有目标 app 且允许创建时新建应用。

严格禁止 (NEVER DO)

  • 不要编造 appType,必须从命令返回的 JSON 中提取
  • 不要在未确认 corpId 的情况下创建应用(先运行 openyida env 确认登录态)
  • 不要在同一轮已成功创建应用后重复创建。若接口明确返回名称冲突,单点任务先询问用户;yida-app 完整应用统一编排可追加短后缀重试一次,不要为了查重额外探测。
  • 已有 appType、应用 URL、已绑定 app 或 workspace app 时,不要创建新应用;除非用户明确要求新建另一个应用并确认。

严格要求 (MUST DO)

  • 创建成功后,将 appType 记录到 .cache/<项目名>-schema.json
  • 若完整搭建已确认 PRD 和视觉设计,创建成功后不得回写 .cache/openyida/<项目名>/requirement-brief.json,也不得仅因拿到真实 appType 重新生成或校验 PRD 和视觉设计;真实 appType 只写入 schema 或当前任务资源上下文。
  • 创建前确认当前登录的组织(corpId)与目标组织一致
  • 本技能不读写 memory:appType 等信息输出到 stdout,通过 .cache/<项目名>-schema.json 持久化,不依赖跨会话的 memory 状态

适用场景

用户说"只创建应用壳"、"新建应用并返回 appType",且 resource context 没有目标 app 时使用此技能。 创建应用后,若任务只是创建应用壳则返回真实 appType 即可;若继续完整搭建,把真实 appType 写入 .cache/<项目名>-schema.json 或当前任务资源上下文,然后直接按已经确认的 PRD 与视觉设计执行:创建/更新表单(yida-create-form-page)→ 创建或复用页面(yida-create-page / existing page)→ 发布页面(yida-publish-page)。 后续如果需要自定义页面,源码写到 project/pages/src/<页面名>.canvas.jsx 并发布。


命令

bash
openyida create-app --name <appName> [--desc <description>]
# 提取返回的 appType 后,单独更新应用基础设置
openyida update-app <appType> --theme-file <app-theme.css> --nav-theme light --logo-source appIcon --layout <side|top|l_shape>

openyida create-app 不支持 --json 参数;不要添加 --json。创建成功时命令本身会输出一行 JSON,从该输出中提取 appType。

参数必填默认值说明
appName是—应用名称
description否同 appName应用描述
icon否见下文显式指定优先;否则优先使用命中的行业图标,仅未命中行业时从平台系统图标中随机选择
iconColor否见下文创建时的图标颜色;后续 update-app --theme-file 会同步为 CSS 主色

以下参数只用于 update-app <appType>,不能传给 create-app:

更新参数作用
--colour / --theme平台主题 key,例如 podBlue、podGreen、podOrange、black、custom;禁止填写 HEX、RGB 或自造名称
--nav-themelight / dark / white / gray
--layout顶部传 top、侧边传 side、L 型传 l_shape;CLI 写入接口字段 layoutDirection,使用平台导航时同时传 --show-app-nav
--theme-file上传主题 CSS,保存 customThemeStyle 资源及从 CSS 提取的 themeColor
--theme-color仅更新应用主色;与主题文件同传时以 CSS 主色为准
--logo-sourceappIcon / customImage;后者要求应用已有 homepageLogo
--hide-app-nav / --show-app-nav隐藏或显示应用原生导航

主题确认后立即生成 CSS,可与表单创建和页面开发并行;真实 appType 与 CSS 就绪后立即更新,不等待页面完成。OpenYida 统一在 CSS 生成后通过一次 update-app 同步 colour、themeColor、customThemeStyle、navTheme、logoSource、layoutDirection 和导航显隐。创建命令不接受或提交这些设置字段。

Show full SKILL.md (220 more words)Show less

创建应用壳层兜底

如果用户只说“创建一个律所/茶叶官网/数据大屏应用”,先由 yida-design 根据行业、品牌、业务情绪和视觉目标设计任意合适的品牌色,禁止把行业词直接映射成固定颜色。把完整色盘写入应用主题 CSS;获得真实 appType 后,必须执行 update-app --theme-file 上传该文件并保存到应用基础设置,同时保存导航主题、Logo 来源和导航布局。

创建命令只提交名称、描述、图标和必要的创建标记,不推断或提交应用主题与导航配置。创建完整应用、使用 PRD/design.md 或用户要求配置主题时,主题更新命令默认传入主题文件;只有用户明确只创建空壳或暂不配置主题时才跳过主题更新。搭建流程必须采用先 create-app、再 update-app --theme-file 的两个步骤。create-app 不接受 --theme-file 和 --logo-source,也不接受 --colour、--theme、--nav-theme、--layout 或旧位置参数里的主题与布局,不隐式执行应用设置更新。

CLI 始终按“显式 --icon → 行业推断 → 随机系统图标”的顺序选择图标,只有未显式指定且未命中行业时才随机,与后续是否更新主题文件无关。主题文件生成后按 PRD 在 update-app --layout 中显式设置布局;用户未指定布局时按业务场景选择,不固定使用 l_shape。参数映射与保存后核对遵守 平台导航参数。在 update-app --theme-file 步骤中校验 CSS 并将图标颜色统一为 --color-brand1-6 转换后的 HEX;导航配置沿用 PRD,普通浅色方案显式传 --nav-theme light --logo-source appIcon。

应用主题(colour)口径:

默认不要把黑色、深灰或灰黑中性色作为普通应用主题色。创建业务系统、工作台、门户、数据管理类应用时,先根据行业、品牌、业务情绪和视觉目标做创意色彩判断;podBlue、podGreen、podOrange 只是常用浅底候选,不是固定默认,也不是行业刻板答案。black 仅在用户明确要求暗色模式、高对比、奢侈品牌或极简黑色视觉时使用,greyBlue 也只在工业制造、技术工程等稳重场景下作为 fallback。

主题颜色不受平台预置 key 限制。先执行以下命令复制内置主题模板,再定点修改品牌相关 token:

bash
openyida sample yida-design app-theme --output .cache/openyida/<项目名>/app-theme.css --design-file prd/<项目名>/design.md

将任意设计主色写入 --color-brand1-6 后执行:

bash
openyida create-app --name "<应用名>" --desc "<描述>"
# 从创建结果提取 appType 后执行;以下为 PRD 选择平台顶部导航的示例
openyida update-app <appType> --theme-file <app-theme.css> --nav-theme light --logo-source appIcon --layout top --show-app-nav

CLI 会先校验主题文件完整声明平台实际生成的 --color-brand1-1/2/3/5/6/9/10,并允许不存在 --color-brand1-4/7/8。update-app --theme-file 上传 CSS,再调用应用基础设置的 updateApp 接口联合保存从 --color-brand1-6 提取的 themeColor、customThemeStyle、navTheme、logoSource 和 layoutDirection。更新主题时,系统应用图标会同步保存为 iconName%%主题色HEX;外链或上传图片图标保持原值。

colour 只保存平台 key,实际色值保存在 themeColor。导入主题文件时自动使用 colour=custom,无需手动填写;显式 --colour custom 需要主题文件或有效主题色,已有有效主题色可沿用。平台预置 key 不能与自定义 CSS 或 --theme-color 同传;切换预置主题会清空旧自定义 CSS。

更新结果必须包含 themeVerification.verified=true 和非空的 customThemeStyle.cssUrl,证明主题资源已绑定到应用设置;仅有本地 CSS 或创建成功不代表主题已应用。回读失败时保留已有 appType,修复后重试 update-app --theme-file,不要重复创建应用。修改 CSS 后也必须重新上传保存。

完整应用主题 key、颜色倾向和 token 变量统一维护在 yida-design/references/theme/theme-token-presets.md,本技能不重复维护完整清单。

输出

json
{"success":true,"appType":"APP_XXX","appName":"考勤管理","url":"{base_url}/APP_XXX/workbench"}

图标列表

名称标识名称标识
新闻xian-xinwen地球xian-diqiu
政府xian-zhengfu汽车xian-qiche
应用xian-yingyong飞机xian-feiji
学术帽xian-xueshimao电脑xian-diannao
企业xian-qiye工作证xian-gongzuozheng
单据xian-danju购物车xian-gouwuche
市场xian-shichang信用卡xian-xinyongka
经理xian-jingli活动xian-huodong
法律xian-falv奖杯xian-jiangbei
报告xian-baogao流程xian-liucheng
火车huoche查询chaxun
申报shenbao打卡daka

图标背景色:update-app --theme-file 时固定跟随 CSS 的 --color-brand1-6;下面这些颜色仅用于应用创建时的初始图标:#0089FF #00B853 #FFA200 #FF7357 #5C72FF #85C700 #FFC505 #FF6B7A #8F66FF #14A9FF

创建后交付约定

  • 将 appType、页面 formUuid、表单 fieldId 写入 .cache/<项目名>-schema.json,PRD 只保留业务语义。
  • 自定义页面源码默认使用 .canvas.jsx,完成编写后发布。
  • 造测试数据或修旧数据时,可以用 Python 或 JS 编写 .cache/ 下的一次性脚本;优先选择更快更清晰的方式,但字段 ID 和记录 ID 必须来自真实查询。

异常处理

异常场景处理方式
命令返回失败(非 success)检查登录态(openyida env),确认 corpId 正确
应用名称重复询问用户是否使用已有应用,或修改应用名称后重试
登录态失效(401)执行 openyida login 重新登录后重试
返回 JSON 中无 appType不要猜测 appType,重新执行命令获取

© 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

Just SKILL.md in yida-skills/skills/yida-create-app of openyida/openyida.

Open the folder on GitHubat commit 3dd4693

Compare with similar skills

Yida Create App 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 Create App compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yida Create App this skillopenyida/openyida220—~1.7kAutomated safety check: PassMIT
Yida DevLeoYeAI/openclaw-master-skills2.2k—~5kAutomated safety check: PassMIT
Yida Dashboardopenyida/openyida220—~1.4kAutomated safety check: PassMIT
Yida Appopenyida/openyida220—~2.2kAutomated safety check: PassMIT
Yida I18nopenyida/openyida220—~909Automated safety check: PassMIT
Yida Tingjiopenyida/openyida220—~283Automated safety check: PassMIT

Similar skills

  • Yida Dev

    LeoYeAI/openclaw-master-skills

    钉钉宜搭低代码开发助手。用于创建表单和自定义页面、编写 JS 动作面板、使用 JS-API、配置数据源、设计流程自动化。适用于宜搭表单开发、JS 代码调试、API 集成等场景。

    2.2k GitHub stars~5k tokensUpdated 2 mo ago
    Auto-check passed
  • Yida Dashboard

    openyida/openyida

    经营分析看板/驾驶舱/数据大屏产品化交付;用于指标判断、趋势分析或投屏监控,不用于普通待办工作台和办事门户。含真实数据、筛选联动、卡片截图、组织内短链和钉钉待办闭环。常规图表使用 yida-rechart;明确 ECharts、复杂 ECharts option 或维护旧图表时使用 yida-chart。普通统计优先 yida-report。

    220 GitHub stars~1.4k tokensUpdated 8 days ago
    Frontend & DesignAuto-check passed
  • Yida App

    openyida/openyida

    创建完整宜搭应用,或补齐已有应用时使用。先确认核心功能和实际用法;Fast 直接搭建,Plan 先确认方案。由 yida-prd 和 yida-design 同时准备业务与基础视觉,校验后创建或复用资源;表单/流程先于自定义页面。页面 UI 按已确认设计实现,代码示例按需参考;前后台都规划菜单顺序与默认页面,发布后分别验收实际入口。

    220 GitHub stars~2.2k tokensUpdated 8 days ago
    Product & Project ManagementAuto-check passed
  • Yida I18n

    openyida/openyida

    应用多语言管理。查询和维护宜搭应用的语言配置、文案词条、翻译状态、一键翻译和多语言升级。适用于全球化设置 / 多语言管理页面;需要应用已开通国际化能力包,或运行在 Global YiDA 环境(默认入口为 www.yidaapps.com,且支持客户自定义二级域名)。

    220 GitHub stars~909 tokensUpdated 8 days ago
    Frontend & DesignAuto-check passed
  • Yida Tingji

    openyida/openyida

    按 taskUuid 获取钉钉听记、会议录音转写、会议纪要或 AI 听记的完整详情;只负责读取内容。若用户要求转 PRD,先用本技能取内容,再交给 yida-flash-note-to-prd。

    220 GitHub stars~283 tokensUpdated 8 days ago
    Product & Project ManagementAuto-check passed
  • Yida Chart

    openyida/openyida

    ECharts 高级可视化报表。依赖宜搭原生报表 getDataAsync.json 接口获取聚合数据,禁止前端聚合。触发词:「更美观」「ECharts」「大屏」「定制化」。普通「报表」「统计」需求默认由 yida-report 处理。

    220 GitHub stars~1.7k tokensUpdated 8 days ago
    Auto-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 8 days ago
    Auto-check passed
  • Openyida Release

    openyida/openyida

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

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

    openyida/openyida

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

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

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

Questions about Yida Create App

What does Yida Create App do?

创建宜搭应用并返回 appType;仅当没有目标 app 且用户意图允许新建时使用. An agent skill from openyida/openyida. Yida Create App is an agent skill from openyida/openyida.

How do I install Yida Create App in Claude Code?

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

How do I install Yida Create App in Codex?

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

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

What does Yida Create App need to run?

SKILL.md names no scripts, command-line tools or credentials: Yida Create App is instructions for the agent only. Our summary lists: Python 3.

Does Yida Create App access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

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

Yida Create App 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 Create App use?

About 1.7k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Yida Create App?

Skills that share tags, products or a category with Yida Create App: Yida Dev (LeoYeAI/openclaw-master-skills, 2.2k stars), Yida Dashboard (openyida/openyida, 220 stars), Yida App (openyida/openyida, 220 stars) and Yida I18n (openyida/openyida, 220 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yida Create App?

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.