Agent skill

Update Gallery Maintain Docs

by AtomUI in AtomUI/AtomUI

A skill your agent uses when AtomUI Gallery code changes require updates to maintenance documentation under docs/Maintain/AtomUIGallery, especially after ReactiveUI upgrades, architecture changes…

LGPL-3.0Auto-check passedDevelopment

Install Update Gallery Maintain Docs

skills CLI
$ npx skills add AtomUI/AtomUI --skill update-gallery-maintain-docs -a claude-code

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

GitHub CLI
$ gh skill install AtomUI/AtomUI update-gallery-maintain-docs --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/AtomUI/AtomUI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/update-gallery-maintain-docs .claude/skills/update-gallery-maintain-docs && 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
update-gallery-maintain-docs
GitHub stars
842
Token cost
~922 tokens
SKILL.md length
201 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
LGPL-3.0

At a glance

A skill your agent uses when AtomUI Gallery code changes require updates to maintenance documentation under docs/Maintain/AtomUIGallery, especially after ReactiveUI upgrades, architecture changes…

  • Works in 5 steps: 请用户提供本次修改的 Git 提交哈希或变更文件列表。如果无法提供,请扫描… → 你需要特别注意整体架构的变更,例如新增了哪些核心类、修改了哪些核心类的职责、引入了… → 我们底层是基于 ReactiveUI 和 Avalonia… → …
  • AtomUI Gallery code changes require updates to maintenance documentation under docs/Maintain/AtomUIGallery
  • SKILL.md covers 名称, 触发条件, Gallery 项目源码 and Gallery 项目维护文档, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Update Gallery Maintain Docs is an agent skill from AtomUI/AtomUI. Use when AtomUI Gallery code changes require updates to maintenance documentation under docs/Maintain/AtomUIGallery, especially after ReactiveUI upgrades, architecture changes, API changes, routing updates, or Gallery ViewModel/View refactors.

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

It sits in Development, covering Refactoring. It works with Avalonia. The repository describes itself as: An enhancement and extension library for Avalonia, bringing the Ant Design design language, modern controls, theming, native integrations, and cross-platform UI capabilities to… The licence is LGPL-3.0.

When your agent uses it

  • AtomUI Gallery code changes require updates to maintenance documentation under docs/Maintain/AtomUIGallery
  • Especially after ReactiveUI upgrades
  • Architecture changes
  • Routing updates

Example prompts

  • “/update-gallery-maintain-docs”

Workflow steps

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

  1. 请用户提供本次修改的 Git 提交哈希或变更文件列表。如果无法提供,请扫描 Gallery 相关项目项目,对比最近两次提交或最近一次重要提交。
  2. 你需要特别注意整体架构的变更,例如新增了哪些核心类、修改了哪些核心类的职责、引入了哪些新的设计模式等,这些都是文档中需要重点更新的内容。
  3. 我们底层是基于 ReactiveUI 和 Avalonia 的,所以你需要特别关注与这两个框架相关的变更,尤其是 ReactiveUI 的升级可能会涉及到 WhenActivated、ViewModelActivator、路由机制等方面的变更。
  4. 识别变更类型
  5. 提取每个变更的旧写法和新写法,并记录变更原因(例如 API 弃用、性能优化、规范统一)。

What it can do on your machine

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

    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

Update Gallery Maintain Docs loads about 922 tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 201 words of instructions outside code blocks.

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

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 AtomUI/AtomUI at commit e82b36c, republished under its LGPL-3.0 licence (© AtomUI). 201 words, ~922 tokens.

Download SKILL.mdSave it as .claude/skills/update-gallery-maintain-docs/SKILL.md (or your agent's skills folder).
name
update-gallery-maintain-docs
description
Use when AtomUI Gallery code changes require updates to maintenance documentation under docs/Maintain/AtomUIGallery, especially after ReactiveUI upgrades, architecture changes, API changes, routing updates, or Gallery ViewModel/View refactors.

名称

update-gallery-maintain-docs

触发条件

当 Gallery 项目完成一次重要的代码升级或重构(例如 ReactiveUI 版本升级、架构调整、API 变更)后,需要更新 docs/Gallery 下的维护文档时,使用本 SKILL。

gallery 项目的源码主要在以下三个地方,非常重要,你务必要仔细分析这三个项目的代码修改,才能正确更新文档!!!!!

  • Gallery 基础项目:controlgallery/AtomUIGallery,这个项目包含了大部分的 ViewModel 和 ShowCase 相关代码,是文档更新的重点。
  • Gallery 主项目:controlgallery/AtomUIGallery.Desktop,这个项目 Gallery 的主入口,包含了 App.xaml.cs、ViewLocator、依赖注入容器配置等全局相关代码。

Gallery 项目的维护文档主要位于 docs/Maintain/AtomUIGallery 目录下,每次生成维护文档前,你需要认真分析已有的维护文档内容,找出与当前代码库不一致的部分,并根据实际代码修改进行更新。

输入要求

  • 本次代码修改的简要描述(例如:“将 ReactiveUI 从旧版本升级到 23.1.8,并重构了 WhenActivated 用法”)
  • 修改涉及的文件列表(可由 Git diff 或用户提供)
  • 目标文档路径:docs/Maintain/AtomUIGallery
  • 如果对应的文档存在,除非大规模修改了文件的内容,尽量在原有文档上修订,而不是创建新文档。

执行步骤

第一步:分析代码修改
  1. 请用户提供本次修改的 Git 提交哈希或变更文件列表。如果无法提供,请扫描 Gallery 相关项目项目,对比最近两次提交或最近一次重要提交。
  2. 你需要特别注意整体架构的变更,例如新增了哪些核心类、修改了哪些核心类的职责、引入了哪些新的设计模式等,这些都是文档中需要重点更新的内容。
  3. 我们底层是基于 ReactiveUI 和 Avalonia 的,所以你需要特别关注与这两个框架相关的变更,尤其是 ReactiveUI 的升级可能会涉及到 WhenActivated、ViewModelActivator、路由机制等方面的变更。
  4. 识别变更类型:
    • 全局配置变更(App.xaml.cs、ViewLocator、依赖注入容器等)
    • ViewModel 基类或公共逻辑变更
    • 路由和导航服务的变更
    • 控件演示页面的 ViewModel/View 代码变更(特别是 WhenActivated、ReactiveCommand 等)
    • 包引用升级(.csproj 文件)
  5. 提取每个变更的旧写法和新写法,并记录变更原因(例如 API 弃用、性能优化、规范统一)。
  1. 列出 docs/Maintain/AtomUIGallery 目录下的所有 .md 文件。
  2. 对于每个文件,读取其内容并分析其结构(例如章节标题、代码示例、图表等),找出与本次代码修改相关的部分。
  3. 如果某些文件不存在,请准备创建它们。
第三步:对比并确定需要更新的文档

对每个现有文档:

  • 找出其中与本次代码修改不一致的描述(例如文档中写的是旧的 WhenActivated 签名,但代码已更新为新签名)。
  • 找出缺失的内容(例如新引入的 ViewModelActivator 用法未在文档中说明)。
  • 标记哪些文档完全过时需要重写,哪些只需局部修改。
第四步:生成或更新文档

遵循以下规则更新文档:

  1. 明确标记变更:对于修改的内容,使用 > **【已更新】** 或 [UPDATE: ReactiveUI 23.1.8] 等标记,便于未来追溯。
  2. 保留有效旧内容:如果旧文档中某些部分仍然正确(例如项目结构说明、第三方依赖列表),不要删除。
  3. 添加迁移指南:如果本次升级涉及破坏性变更,请在 UPGRADE_LOG.md 或单独的 MIGRATION_GUIDE.md 中记录从旧写法到新写法的转换步骤。
  4. 更新代码示例:所有代码块中的示例必须与当前代码库中的实际写法一致。
  5. 更新架构图:如果架构有变化(例如新增了服务类、改变了数据流),请用 Mermaid 格式更新 ARCHITECTURE.md 中的图表。
第五步:输出文档

将更新后的文档写入以下路径: docs/Maintain/AtomUIGallery 另外,生成一个变更摘要文件:docs/Maintain/AtomUIGallery/CHANGELOG_DOCS.md,内容为表格形式,列出每个文档文件的变更类型(新增/修改/删除/无变更)和简要说明。

第六步:向用户报告

完成后,输出以下信息:

  • 本次更新的文档列表
  • 每个文档的主要变更点摘要(3-5 条)
  • 如果有任何无法自动决策的内容(例如矛盾信息、缺失信息),请明确指出并请求用户提供补充。

注意事项

  • 不要凭空捏造:所有文档内容必须基于实际代码修改,不能猜测或加入未实现的设计。
  • 保持一致性:文档中的术语、命名规范应与代码保持一致。
  • 优先使用官方术语:ReactiveUI 相关概念(如 WhenActivated、ViewModelActivator、RoutableViewModel)应使用官方名称。
  • 如果用户提供了额外的参考文档(如 .referenceprojects/ReactiveUI 中的官方指南),应优先参考它们来解释变更。

示例执行流程(供 Agent 参考)

假设本次升级是将 ReactiveUI 从 11.0.10 升级到 23.1.8,主要变化是将所有 WhenActivated 的用法从旧委托形式改为新的 disposables 参数形式,并且 ViewLocator 实现有调整。

Agent 应:

  1. 扫描所有 .cs 文件,找出所有 WhenActivated 的旧写法(例如 WhenActivated(d => { ... }))已被改为新写法(WhenActivated(disposables => { ... }))。
  2. 扫描 docs/Maintain/AtomUIGallery 路径下已经存在的文档的所有文档,根据扫描代码得到的变更点,找出哪些文档中提到了 WhenActivated 的旧写法,并标记需要更新。
  3. 生成 CHANGELOG_DOCS.md,列出上述修改。
  4. 向用户报告完成情况。

附:推荐的文档结构(供创建新文档时参考)

如果某个文档不存在,按以下模板创建:

  • ARCHITECTURE.md:项目整体架构(Mermaid 图)、模块职责、数据流、外部依赖。
  • CODING_STANDARDS.md:命名规范、ReactiveUI 使用规范(WhenActivated、ReactiveCommand、路由)、XAML 规范、异常处理。
  • ROUTING.md:路由注册方式、导航服务使用示例、ViewLocator 配置。
  • UPGRADE_LOG.md:按时间倒序记录每次升级(包版本、变更摘要、迁移说明)。
  • MAINTENANCE.md:常见维护任务(添加新页面、修复 Bug)、调试技巧、验证清单。

© AtomUI, LGPL-3.0. 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 .agents/skills/update-gallery-maintain-docs of AtomUI/AtomUI.

Open the folder on GitHubat commit e82b36c

Compare with similar skills

Update Gallery Maintain Docs 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.

Update Gallery Maintain Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Update Gallery Maintain Docs this skillAtomUI/AtomUI842—~922Automated safety check: PassLGPL-3.0
Winforms To Avaloniatautcony/ChapterTool113—~1.2kAutomated safety check: PassGPL-3.0
Fieldworks Code Commentingsillsdev/FieldWorks110—~2.4kAutomated safety check: PassCustom licence
Guidelinesakash-network/node1.1k22 repos~577Automated safety check: PassMIT
Component Refactoringlangflow-ai/langflow156k—~3.5kAutomated safety check: PassMIT
Migrate Core Code to Submodulestinyhumansai/openhuman42k—~2.6kAutomated safety check: PassGPL-3.0

Similar skills

  • Winforms To Avalonia

    tautcony/ChapterTool

    Orchestrate a phased WinForms-to-Avalonia migration: behavior contracts, UI-independent application logic, platform adapters, MVVM shell, parity/cutover, evolution, and hardening.

    113 GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Fieldworks Code Commenting

    sillsdev/FieldWorks

    The FieldWorks code-comment standard for C, C/C++, IDL, PowerShell, and project-file/Avalonia-view XML comments.

    110 GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Guidelines

    akash-network/node

    Behavioral guidelines to reduce common LLM coding mistakes. An agent skill from akash-network/node.

    1.1k GitHub starsUsed in 22 repos~577 tokens
    DevelopmentAuto-check passed
  • Component Refactoring

    langflow-ai/langflow

    Refactor high-complexity React components in Langflow frontend.

    156k GitHub stars~3.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Migrate Core Code to Submodules

    tinyhumansai/openhuman

    Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.

    42k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Systematic Code Refactoring

    luongnv89/claude-howto

    Guides refactoring in phases based on Martin Fowler's method: research, test coverage check, planning and small tested steps, with your approval at each phase.

    42k GitHub stars~3k tokensUpdated 7 days ago
    DevelopmentAuto-check passed

More from AtomUI/AtomUI

All 15 skills in this repo
  • A skill your agent uses when building, launching, debugging, or visually inspecting AtomUIGallery.Desktop from an AtomUI checkout where installed or mounted Gallery apps may share its name or bundle…

    842 GitHub stars~983 tokensUpdated today
    Auto-check passed
  • Atomui Commit Msg

    AtomUI/AtomUI

    Generate a single-line commit message for AtomUI by reading the project's git staged area and recent commit style.

    842 GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • A skill your agent uses when optimizing, refactoring, reviewing, or fixing AtomUI controls, including control API contracts, member layout, file splitting, lifecycle, AXAML structure, correctness…

    842 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • A skill your agent uses when creating, completing, splitting, reviewing, or synchronizing AtomUI control documentation under docs/controls, including overview.md, implementation.md, token.md…

    842 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • A skill your agent uses when changing AtomUI or Avalonia resource bindings, DynamicResource, TokenResourceBinder, non-Visual AvaloniaObject lifecycle, IResourceHost/IThemeVariantHost…

    842 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • A skill your agent uses when upgrading AtomUI NuGet dependencies, source dependency projects, ReactiveUI, Avalonia, Splat, or any third-party version where compatibility must be evaluated before…

    842 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Update Gallery Maintain Docs

What does Update Gallery Maintain Docs do?

A skill your agent uses when AtomUI Gallery code changes require updates to maintenance documentation under docs/Maintain/AtomUIGallery, especially after ReactiveUI upgrades, architecture changes…. Update Gallery Maintain Docs is an agent skill from AtomUI/AtomUI. Use when AtomUI Gallery code changes require updates to maintenance documentation under docs/Maintain/AtomUIGallery, especially after ReactiveUI upgrades, architecture changes, API changes, routing updates, or Gallery ViewModel/View refactors.

When should I use Update Gallery Maintain Docs?

Update Gallery Maintain Docs fits situations like: atomUI Gallery code changes require updates to maintenance documentation under docs/Maintain/AtomUIGallery; especially after ReactiveUI upgrades; architecture changes; routing updates.

How do I install Update Gallery Maintain Docs in Claude Code?

Run `npx skills add AtomUI/AtomUI --skill update-gallery-maintain-docs -a claude-code`. Or copy the skill folder (.agents/skills/update-gallery-maintain-docs in AtomUI/AtomUI) into .claude/skills/update-gallery-maintain-docs in your project. Claude Code loads it when a task matches its description.

How do I install Update Gallery Maintain Docs in Codex?

Run `npx skills add AtomUI/AtomUI --skill update-gallery-maintain-docs -a codex`. Or copy the skill folder (.agents/skills/update-gallery-maintain-docs in AtomUI/AtomUI) into .agents/skills/update-gallery-maintain-docs in your project. Codex loads it when a task matches its description.

Can I use Update Gallery Maintain Docs 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 AtomUI/AtomUI --skill update-gallery-maintain-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/update-gallery-maintain-docs, .gemini/skills/update-gallery-maintain-docs, .github/skills/update-gallery-maintain-docs and .opencode/skills/update-gallery-maintain-docs in your project.

What does Update Gallery Maintain Docs need to run?

SKILL.md names no scripts, command-line tools or credentials: Update Gallery Maintain Docs is instructions for the agent only.

Does Update Gallery Maintain Docs 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 Update Gallery Maintain Docs 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 Update Gallery Maintain Docs use?

Update Gallery Maintain Docs is published under the LGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Update Gallery Maintain Docs use?

About 922 tokens (SKILL.md is roughly 3.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 Update Gallery Maintain Docs?

Skills that share tags, products or a category with Update Gallery Maintain Docs: Winforms To Avalonia (tautcony/ChapterTool, 113 stars), Fieldworks Code Commenting (sillsdev/FieldWorks, 110 stars), Guidelines (akash-network/node, 1.1k stars) and Component Refactoring (langflow-ai/langflow, 156k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Update Gallery Maintain Docs?

AtomUI (a GitHub organization) maintains it in AtomUI/AtomUI, which has 842 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 7, 2026.

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