Agent skill

Yida Openyida Publish Guard

by openyida in openyida/openyida

Prevent stale local OpenYida custom page source from overwriting live designer edits.

MITAuto-check passed

Install Yida Openyida Publish Guard

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

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

GitHub CLI
$ gh skill install openyida/openyida yida-openyida-publish-guard --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-openyida-publish-guard .claude/skills/yida-openyida-publish-guard && 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-openyida-publish-guard
GitHub stars
221
Token cost
~1.2k tokens
SKILL.md length
637 words
Files
1
Skills in repo
59
Repo updated
First seen
Licence
MIT

At a glance

Prevent stale local OpenYida custom page source from overwriting live designer edits.

  • Works in 3 steps: Confirm the target appType, formUuid,… → Check the OpenYida environment and login… → Fetch the live schema before editing or…
  • S may have edited the page in the designer after local source was last copied
  • SKILL.md covers Purpose, When To Use, Required Workflow and Minimal Diff Discipline, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Yida Openyida Publish Guard is an agent skill from openyida/openyida. Prevent stale local OpenYida custom page source from overwriting live designer edits. Use before modifying, compiling, or publishing an existing Yida custom page, display page, pageDesigner URL, or formUuid with openyida publish, especially when users may have edited the page in the designer after local source was last copied.

Its SKILL.md is about 1.2k 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.

When your agent uses it

  • S may have edited the page in the designer after local source was last copied

Example prompts

  • “/yida-openyida-publish-guard”

Workflow steps

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

  1. Confirm the target appType, formUuid, and local source path.
  2. Check the OpenYida environment and login state
  3. Fetch the live schema before editing or publishing

What it can do on your machine

Read from SKILL.md and the folder at commit 04de959. 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

    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 Openyida Publish Guard loads about 1.2k tokens when it runs. Until then it costs about 89 tokens; SKILL.md has 637 words of instructions outside code blocks.

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

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 04de959, republished under its MIT licence (© openyida). 637 words, ~1,236 tokens.

Download SKILL.mdSave it as .claude/skills/yida-openyida-publish-guard/SKILL.md (or your agent's skills folder).
name
yida-openyida-publish-guard
description
Prevent stale local OpenYida custom page source from overwriting live designer edits. Use before modifying, compiling, or publishing an existing Yida custom page, display page, pageDesigner URL, or formUuid with openyida publish, especially when users may have edited the page in the designer after local source was last copied.

OpenYida Publish Guard

Purpose

Use this skill whenever an existing OpenYida custom page is about to be edited or published from local source.

The Yida designer is also a source of truth. Users can make small live edits in the designer, such as deleting a query button, while the local .oyd.jsx file still contains older code. Publishing that stale local file will silently restore the deleted UI or roll back other live changes.

This skill adds a mandatory online-state check before publishing so agents merge requested changes onto the current live page instead of overwriting it.

When To Use

Use this skill for:

  • Any openyida publish to an existing custom page.
  • Any request that mentions a pageDesigner URL, display page, custom page JSX, or formUuid.
  • Any targeted page edit where the user says "only change X" or "do not touch other code".
  • Any situation where the user or another editor may have changed the page in the Yida designer after the local source was created.

Do not use this skill for creating a brand-new page that has no existing live schema.

Required Workflow

  1. Confirm the target appType, formUuid, and local source path.
  2. Check the OpenYida environment and login state:
bash
openyida env --json
openyida login --check-only --json
  1. Fetch the live schema before editing or publishing:
bash
openyida get-schema <appType> <formUuid> --json

If the schema needs to be inspected from a file, save stdout with the agent's structured file write tool to <projectRoot>/.cache/openyida/publish-guard/live-<formUuid>.json. From the workspace root that path is typically project/.cache/openyida/publish-guard/live-<formUuid>.json. Do not use shell redirection and do not commit fetched live schema files.

  1. Inspect the fetched live page for current code and configuration. For custom display pages, check at least:
  • pages[].componentsTree[].methods.__initMethods__.source
  • pages[].componentsTree[].methods.__initMethods__.compiled
  • JSX render source under componentsTree when present
  • dataSource.online and existing connector or page-level data source definitions
  • Any visible component tree change that could represent a designer edit
  1. Compare the live source with the local source before publishing.
  • If the local source is older or missing a user-visible live change, merge the requested change into the live/current behavior.
  • If the user explicitly says "only change X", verify the final diff only touches X and strictly required helper or style code.
  • If live and local differ in unrelated user-visible areas, pause and ask whether to preserve the live changes unless the preservation is obvious.
  • Exception: only when the user explicitly says "use local source" may you skip live-source merging. You must still run env check -> check-page -> compile -> publish --health-check. Skipping live-source merging does not mean skipping safety checks.
  1. Only after the merge is scoped and reviewed, run:
bash
openyida check-page <source>
openyida compile <source>
openyida publish <source> <appType> <formUuid> --health-check
Show full SKILL.md (217 more words)Show less

Minimal Diff Discipline

  • Do not reformat the file.
  • Do not regenerate the entire page unless explicitly requested.
  • Do not replace a page with an older local copy.
  • Keep deleted live UI deleted unless the user asks to restore it.
  • Preserve existing page data sources; confirm publish output reports retained data sources.
  • Search the final local source for accidentally restored labels or controls from the bug report, such as 查询, queryButton, or other recently removed UI.

Incident That Motivated This Skill

While editing a Junjie Yida ranking page, a user had deleted the query button directly in the Yida designer. A later targeted change was published from an older local .oyd.jsx file without first checking the live designer schema. The stale publish restored the deleted query button and overwrote the user's immediate designer edit.

The fix was to restore the deleted UI state and add this guardrail: before future OpenYida page edits or publishes, fetch the live schema, compare the current live source with local source, and merge the requested change onto the latest live behavior.

Recovery If An Overwrite Happens

  1. Acknowledge the overwrite plainly.
  2. Restore the overwritten live change immediately, without broad refactors.
  3. Re-run openyida check-page, openyida compile, and openyida publish --health-check.
  4. Update this skill if the failure mode is not already covered.

© 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-openyida-publish-guard of openyida/openyida.

Open the folder on GitHubat commit 04de959

Compare with similar skills

Yida Openyida Publish Guard 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 Openyida Publish Guard compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yida Openyida Publish Guard this skillopenyida/openyida221—~1.2kAutomated safety check: PassMIT
Frontend Slideszarazhangrui/frontend-slides30k16 repos~7kAutomated safety check: PassMIT
Algorithmic Art with p5.jsanthropics/skills180k38 repos~4.9kAutomated safety check: PassApache-2.0
Canvas Designanthropics/skills180k52 repos~3kAutomated safety check: PassApache-2.0
Impeccablebestofjs/bestofjs3.1k26 repos~2.6kAutomated safety check: PassMIT
Brand and Design Toolkitnextlevelbuilder/ui-ux-pro-max-skill135k1 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • Frontend Slides

    zarazhangrui/frontend-slides

    Builds animated HTML slide decks that run in the browser with no dependencies, or converts PowerPoint files to the web, starting from visual style previews.

    30k GitHub starsUsed in 16 repos~7k tokens
    Documents & OfficeAuto-check passed
  • Official

    Creates original generative art in two steps: a written algorithmic philosophy, then a p5.js sketch with seeded randomness and an interactive viewer for exploring parameters.

    180k GitHub starsUsed in 38 repos~4.9k tokens
    Media & CreativeAuto-check passed
  • Canvas Design

    anthropics/skills

    Official

    Creates original posters and static art as PNG or PDF by first writing a short design philosophy, then expressing it visually on a canvas.

    180k GitHub starsUsed in 52 repos~3k tokens
    Media & CreativeAuto-check passed
  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 26 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Brand and Design Toolkit

    nextlevelbuilder/ui-ux-pro-max-skill

    Bundles design tasks behind one skill: brand identity, tokens, UI styling, logos, corporate identity mockups, slides, banners, icons and social images.

    135k GitHub starsUsed in 1 repo~3.5k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Animation

    heygen-com/hyperframes

    Collects motion rules, scene blueprints, transitions and runtime adapters for HyperFrames video compositions, with GSAP as the default animation runtime.

    60k GitHub starsUsed in 3 repos~2.1k tokens
    Media & CreativeAuto-check passed

More from openyida/openyida

All 59 skills in this repo
  • Yida Canvas Custom Page

    openyida/openyida

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

    221 GitHub stars~4.3k tokensUpdated yesterday
    Auto-check passed
  • Openyida Release

    openyida/openyida

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

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

    openyida/openyida

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

    221 GitHub stars~756 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.

    221 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、证据验证与回写来低干扰控盘。

    221 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Yida Canvas Data Binding

    openyida/openyida

    自定义页面真实数据接入技能。用于在使用 YidaCodeCanvas 组件实现的页面中用 dataBinding + 发布层 yida/utils window 桥接入宜搭表单、流程 API、连接器代理或同源接口数据,处理返回体包裹解析、totalCount 保护、DataBridge 状态和静默刷新。触发词:dataBinding、DataBridge、数据桥、YidaCodeCanvas…

    221 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed

Questions about Yida Openyida Publish Guard

What does Yida Openyida Publish Guard do?

Prevent stale local OpenYida custom page source from overwriting live designer edits. Yida Openyida Publish Guard is an agent skill from openyida/openyida. Prevent stale local OpenYida custom page source from overwriting live designer edits.

When should I use Yida Openyida Publish Guard?

Yida Openyida Publish Guard fits situations like: S may have edited the page in the designer after local source was last copied.

How do I install Yida Openyida Publish Guard in Claude Code?

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

How do I install Yida Openyida Publish Guard in Codex?

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

Can I use Yida Openyida Publish Guard 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-openyida-publish-guard -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-openyida-publish-guard, .gemini/skills/yida-openyida-publish-guard, .github/skills/yida-openyida-publish-guard and .opencode/skills/yida-openyida-publish-guard in your project.

What does Yida Openyida Publish Guard need to run?

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

Does Yida Openyida Publish Guard 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 Openyida Publish Guard 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 Openyida Publish Guard use?

Yida Openyida Publish Guard 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 Openyida Publish Guard use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 Openyida Publish Guard?

Skills that share tags, products or a category with Yida Openyida Publish Guard: Frontend Slides (zarazhangrui/frontend-slides, 30k stars), Algorithmic Art with p5.js (anthropics/skills, 180k stars), Canvas Design (anthropics/skills, 180k stars) and Impeccable (bestofjs/bestofjs, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yida Openyida Publish Guard?

openyida (a GitHub organization) maintains it in openyida/openyida, which has 221 GitHub stars. The repository holds 59 skills in this directory. The repository was last updated on October 10, 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.