用 MAA GUI 内置演示模式(tools/ReadmeShotDemo)重新生成仓库 README 界面截图。用户提到更新/换 README 截图、README 里的画面过期、UI 大改后要更新 README 展示图、跑 ReadmeShotDemo 或 demo 截图时使用,即使用户没有明确说出 「ReadmeShotDemo」 一词。

AGPL-3.0Auto-check passedDevelopment

Install Readme Shot Demo

skills CLI
$ npx skills add MaaAssistantArknights/MaaAssistantArknights --skill readme-shot-demo -a claude-code

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

GitHub CLI
$ gh skill install MaaAssistantArknights/MaaAssistantArknights readme-shot-demo --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/MaaAssistantArknights/MaaAssistantArknights.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/readme-shot-demo .claude/skills/readme-shot-demo && 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
readme-shot-demo
GitHub stars
24k
Token cost
~579 tokens
SKILL.md length
142 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
AGPL-3.0

At a glance

用 MAA GUI 内置演示模式(tools/ReadmeShotDemo)重新生成仓库 README 界面截图。用户提到更新/换 README 截图、README 里的画面过期、UI 大改后要更新 README 展示图、跑 ReadmeShotDemo 或 demo 截图时使用,即使用户没有明确说出 「ReadmeShotDemo」 一词。

  • Works in 5 steps: 前置检查:build/bin/Debug/MAA.exe 的 mtime 须新于… → 界面基线:演示不写配置,界面开关与参数取 MAA.exe 所在目录… → 截图 → …
  • Tasks that involve Technical documentation
  • SKILL.md covers 工作流程, 演示数据 and 常见错误
  • Calls dotnet and git

What it does

Readme Shot Demo is an agent skill from MaaAssistantArknights/MaaAssistantArknights. 用 MAA GUI 内置演示模式(tools/ReadmeShotDemo)重新生成仓库 README 界面截图。用户提到更新/换 README 截图、README 里的画面过期、UI 大改后要更新 README 展示图、跑 ReadmeShotDemo 或 demo 截图时使用,即使用户没有明确说出 「ReadmeShotDemo」 一词。

Its SKILL.md is about 580 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 Technical documentation. The repository describes itself as: 《明日方舟》小助手,全日常一键长草!| A one-click tool for the daily tasks of Arknights, supporting all clients. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve Technical documentation

Example prompts

  • “/readme-shot-demo”

Requirements

  • Python 3

Workflow steps

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

  1. 前置检查:build/bin/Debug/MAA.exe 的 mtime 须新于 src/MaaWpfGui 的最新提交,过期则先 dotnet build src/MaaWpfGui/MaaWpfGui.csproj -r win-x64(禁…
  2. 界面基线:演示不写配置,界面开关与参数取 MAA.exe 所在目录 config/gui.new.json 的现状(如干员识别头像模式 OperBoxAvatarMode、理智作战各参数)。README 图需要展示某个状态(如头像模式)时,先确认该基线已处于期望状态。
  3. 截图
  4. 压缩:pre-commit run oxipng --files <图片路径>(参数 -q -o 2 -s --ng)。钩子从源码编译 oxipng,本机可能因缺 dlltool 编译失败;此时用 pre-commit 缓存里的同版本产物手动等价跑
  5. 核对:用读图确认新截图内容符合预期(新功能入镜、无占位名、明暗主题正确)后再覆盖;覆盖后 git status 确认只有目标页变更。

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • dotnet
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Readme Shot Demo loads about 579 tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 142 words of instructions outside code blocks.

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

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 MaaAssistantArknights/MaaAssistantArknights at commit c7e8b26, republished under its AGPL-3.0 licence (© MaaAssistantArknights). 142 words, ~579 tokens.

Download SKILL.mdSave it as .claude/skills/readme-shot-demo/SKILL.md (or your agent's skills folder).
name
readme-shot-demo
description
用 MAA GUI 内置演示模式(tools/ReadmeShotDemo)重新生成仓库 README 界面截图。用户提到更新/换 README 截图、README 里的画面过期、UI 大改后要更新 README 展示图、跑 ReadmeShotDemo 或 demo 截图时使用,即使用户没有明确说出 「ReadmeShotDemo」 一词。

MAA README 截图(ReadmeShotDemo)

MAA GUI 内置演示模式:加载 tools/ReadmeShotDemo/readme-demo-data.json,按数据渲染界面并自动截图,产出仓库 README 所用全部图片(5 语言 × 4 页 × 明暗主题共 40 张)后自动退出。演示不连模拟器、不写任何配置与数据文件;唯一联网点是标题版本段取 latest 时查询一次 GitHub 最新 Release(失败静默回退本机版本,不阻塞)。

页面编号与语言目录:输出为 <输出目录>/<lang>/readme/N-{light,dark}.png,与 docs/.vuepress/public/images/ 结构一致。

N页面
1一键长草
2自动战斗
3小工具 - 干员识别
4小工具 - 仓库识别

引用范围:仓库根 README.md 用 zh-cn 图;docs/<lang>/readme.md 各引用同语言图。更新任何一页时 5 个语言目录一起换,保持语言间一致。

工作流程

  1. 前置检查:build/bin/Debug/MAA.exe 的 mtime 须新于 src/MaaWpfGui 的最新提交,过期则先 dotnet build src/MaaWpfGui/MaaWpfGui.csproj -r win-x64(禁 --no-self-contained 与裸 -o)。
  2. 界面基线:演示不写配置,界面开关与参数取 MAA.exe 所在目录 config/gui.new.json 的现状(如干员识别头像模式 OperBoxAvatarMode、理智作战各参数)。README 图需要展示某个状态(如头像模式)时,先确认该基线已处于期望状态。
  3. 截图:
    bash
    ./build/bin/Debug/MAA.exe --demo tools/ReadmeShotDemo/readme-demo-data.json --shots "Z:\\maa\\test\\readmeshot"
    只更新部分页面时输出到临时目录,核对内容后仅拷贝目标页到 docs/.vuepress/public/images/<lang>/readme/;全部重截可让 --shots 直接指向 docs/.vuepress/public/images。
  4. 压缩:pre-commit run oxipng --files <图片路径>(参数 -q -o 2 -s --ng)。钩子从源码编译 oxipng,本机可能因缺 dlltool 编译失败;此时用 pre-commit 缓存里的同版本产物手动等价跑:
    bash
    C:/Users/uyee/.cache/pre-commit/repovrlh11g5/target/release/oxipng.exe -q -o 2 -s --ng <图片...>
  5. 核对:用读图确认新截图内容符合预期(新功能入镜、无占位名、明暗主题正确)后再覆盖;覆盖后 git status 确认只有目标页变更。

演示数据

数据字段(任务列表、仓库/干员识别数据、日志、自动战斗页等)与界面部位的对应关系见 tools/ReadmeShotDemo/README.md,改数据以其为准。要点:

  • 所有 text 字段必须包含全部 5 种语言;材料/干员/关卡等名称由 GUI 查表本地化,不受语言影响。
  • operBox 缺省时自动生成全干员满练度数据,无需手工维护名单。
  • 干员识别头像模式由配置基线控制(数据字段不覆盖);理智作战 「指定材料」 下拉显示用 taskQueue.specifiedDrops(材料 itemId,如 30012 固源岩),仅设置显示、不勾选。
  • windowTitle.version 填 latest 联网取最新 Release;新功能先于发版入镜时临时固定为对应版本号(如 v6.19.0),截图完成后还原为 latest。

常见错误

  • ❌ 改 readme-demo-data.json 用 python json.load+dump 全量重写(整文件缩进重排);用文本手术只碰目标行。
  • ❌ 只更新 zh-cn 图,docs 其余语言 readme.md 引用的图停留在旧 UI。
  • ❌ 忘记还原临时固定的 windowTitle.version。
  • ❌ 构建过期就直接跑(截图缺最新 UI)。
  • ❌ 演示数据文案只改 zh-cn(其余语言截图显示回退的中文)。

© MaaAssistantArknights, AGPL-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/readme-shot-demo of MaaAssistantArknights/MaaAssistantArknights.

Open the folder on GitHubat commit c7e8b26

Compare with similar skills

Readme Shot Demo 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.

Readme Shot Demo compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Readme Shot Demo this skillMaaAssistantArknights/MaaAssistantArknights24k—~579Automated safety check: PassAGPL-3.0
Diagram Designcathrynlavery/diagram-design49k1 repos~7.6kAutomated safety check: PassMIT
Simple Englishmoeru-ai/airi50k2 repos~4.6kAutomated safety check: PassMIT
Doc SyncJetBrains/ideavim10k2 repos~2.6kAutomated safety check: PassMIT
Mailspring App ScreenshotsFoundry376/Mailspring18k—~1.5kAutomated safety check: PassGPL-3.0
Draw.io Diagram StudioAgents365-ai/drawio-skill10k—~2.4kAutomated safety check: NotesMIT

Similar skills

  • Diagram Design

    cathrynlavery/diagram-design

    Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.

    49k GitHub starsUsed in 1 repo~7.6k tokens
    DevelopmentAuto-check passed
  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • Doc Sync

    JetBrains/ideavim

    Official

    Keeps IdeaVim documentation in sync with code changes. An agent skill from JetBrains/ideavim.

    10k GitHub starsUsed in 2 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Mailspring App Screenshots

    Foundry376/Mailspring

    Captures screenshots of the running Mailspring dev app for docs, PRs or visual checks by launching it with a debugging port, driving the UI and clipping to an element.

    18k GitHub stars~1.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Draw.io Diagram Studio

    Agents365-ai/drawio-skill

    Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.

    10k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check: notes
  • Dark Architecture Diagram Builder

    Cocoon-AI/architecture-diagram-generator

    Creates dark-themed system, cloud, security and network architecture diagrams as self-contained HTML files with inline SVG and CSS.

    7.4k GitHub starsUsed in 1 repo~2.1k tokens
    DevelopmentAuto-check passed

More from MaaAssistantArknights/MaaAssistantArknights

All 8 skills in this repo
  • Changelog

    MaaAssistantArknights/MaaAssistantArknights

    依据 git 提交、diff、现有 CHANGELOG 与 tag,生成符合 MAA 规范、可直接写入 CHANGELOG.md 的最终 Markdown。用户提到发版、整理/生成 changelog、写更新日志、发布正式版或 beta 时均应使用本 skill,即使用户没有明确说出 "changelog" 一词。

    24k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Core Image Eval

    MaaAssistantArknights/MaaAssistantArknights

    用 MaaCore 本体对本地图片(用户日志反馈包截图、自己截的图)离线验证识别结果:pipeline 任务为什么没命中、模板匹配得分多少、OCR 认出了什么、物品模板匹配情况。用户提到 「验证识别」「为什么没识别/没命中」「模板分数/得分」「OCR 结果对不对」「排查反馈包截图」或给了截图要复现 core 行为时使用。与外部脚本(python 直调 ppocr/OpenCV)的区别:本工具走…

    24k GitHub stars~899 tokensUpdated today
    Auto-check passed
  • Maa Cyber Fortune Master

    MaaAssistantArknights/MaaAssistantArknights

    用“赛博道士 + 故障玄学 + 半懂不懂技术分析”的风格回复 MAA 用户的简略求助。用于用户只给一句模糊问题、没有日志、没有截图、没有报错时,做一段短小离谱但认真的玄学诊断。触发词可包括“赛博算卦”“玄学回复”“评论区整活”“帮我写一段离谱但正经的故障分析”

    24k GitHub stars~692 tokensUpdated today
    Auto-check passed
  • Maa Issue Log Analysis

    MaaAssistantArknights/MaaAssistantArknights

    分析 MaaAssistantArknights 上游仓库公开 Issue(https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/...

    24k GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Pallas Style Reply

    MaaAssistantArknights/MaaAssistantArknights

    以《明日方舟》帕拉斯的人设与语气生成强角色扮演式回复。用于用户明确要求“帕拉斯风格”“帕拉斯口吻”“像帕拉斯一样说话”“Pallas roleplay”时,输出带有米诺斯祭司、英雄叙事、荣誉与信念色彩的中文回复,同时保持内容可理解、可执行。

    24k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Side Story Navigation

    MaaAssistantArknights/MaaAssistantArknights

    新增/更新 SideStory(别传)活动关卡导航。涵盖 tasks/Stages 导航任务、StageActivityV2.json 活动配置、MaaRelease 仓库同步三个文件的联动修改。用户要求添加新活动导航、更新活动关卡、活动开放或复刻时调整导航,以及提到同步 MaaRelease 时均应使用本 skill。

    24k GitHub stars~2.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Readme Shot Demo

What does Readme Shot Demo do?

用 MAA GUI 内置演示模式(tools/ReadmeShotDemo)重新生成仓库 README 界面截图。用户提到更新/换 README 截图、README 里的画面过期、UI 大改后要更新 README 展示图、跑 ReadmeShotDemo 或 demo 截图时使用,即使用户没有明确说出 「ReadmeShotDemo」 一词。. Readme Shot Demo is an agent skill from MaaAssistantArknights/MaaAssistantArknights.

When should I use Readme Shot Demo?

Readme Shot Demo fits situations like: tasks that involve Technical documentation.

How do I install Readme Shot Demo in Claude Code?

Run `npx skills add MaaAssistantArknights/MaaAssistantArknights --skill readme-shot-demo -a claude-code`. Or copy the skill folder (.agents/skills/readme-shot-demo in MaaAssistantArknights/MaaAssistantArknights) into .claude/skills/readme-shot-demo in your project. Claude Code loads it when a task matches its description.

How do I install Readme Shot Demo in Codex?

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

Can I use Readme Shot Demo 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 MaaAssistantArknights/MaaAssistantArknights --skill readme-shot-demo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/readme-shot-demo, .gemini/skills/readme-shot-demo, .github/skills/readme-shot-demo and .opencode/skills/readme-shot-demo in your project.

What does Readme Shot Demo need to run?

Going by SKILL.md and its folder, Readme Shot Demo needs the command-line tools its instructions call (dotnet and git). Our summary lists: Python 3.

Does Readme Shot Demo access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Readme Shot Demo 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 Readme Shot Demo use?

Readme Shot Demo is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Readme Shot Demo use?

About 579 tokens (SKILL.md is roughly 2.3k 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 Readme Shot Demo?

Skills that share tags, products or a category with Readme Shot Demo: Diagram Design (cathrynlavery/diagram-design, 49k stars), Simple English (moeru-ai/airi, 50k stars), Doc Sync (JetBrains/ideavim, 10k stars) and Mailspring App Screenshots (Foundry376/Mailspring, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Readme Shot Demo?

MaaAssistantArknights (a GitHub organization) maintains it in MaaAssistantArknights/MaaAssistantArknights, which has 23,661 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 11, 2026.

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