Agent skill

Atomui Gallery Local Debug

by AtomUI in AtomUI/AtomUI

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…

LGPL-3.0Auto-check passedDevelopment

Install Atomui Gallery Local Debug

skills CLI
$ npx skills add AtomUI/AtomUI --skill atomui-gallery-local-debug -a claude-code

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

GitHub CLI
$ gh skill install AtomUI/AtomUI atomui-gallery-local-debug --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/atomui-gallery-local-debug .claude/skills/atomui-gallery-local-debug && 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
atomui-gallery-local-debug
GitHub stars
842
Token cost
~983 tokens
SKILL.md length
458 words
Files
4 (incl. scripts)
Skills in repo
15
Repo updated
First seen
Licence
LGPL-3.0

At a glance

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…

  • Visually inspecting AtomUIGallery.Desktop from an AtomUI checkout where installed
  • SKILL.md covers Overview, Required Workflow, Options and Verification, plus 2 more sections
  • Runs Shell scripts from its folder; calls bash, git and dotnet
  • Mounted Gallery apps may share its name

What it does

Atomui Gallery Local Debug is an agent skill from AtomUI/AtomUI. Use 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 identifier.

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `agents/openai.yaml`, `scripts/launch-gallery-debug.sh` and `tests/test-launcher-contract.sh`).

It sits in Development, covering Debugging. 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

  • Visually inspecting AtomUIGallery.Desktop from an AtomUI checkout where installed
  • Mounted Gallery apps may share its name
  • Bundle identifier

Example prompts

  • “/atomui-gallery-local-debug”

Requirements

  • A Bash shell

What it can do on your machine

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

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • git
    • dotnet

    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

Atomui Gallery Local Debug loads about 983 tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 458 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from AtomUI/AtomUI at commit d234fe0, republished under its LGPL-3.0 licence (© AtomUI). 458 words, ~983 tokens.

Download SKILL.mdSave it as .claude/skills/atomui-gallery-local-debug/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
atomui-gallery-local-debug
description
Use 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 identifier.

Overview

Launch and identify the Gallery from the current checkout. The build identity, process identity, and UI automation target must all resolve to the same absolute executable path.

Required Workflow

Run from anywhere inside the target AtomUI checkout:

bash
.agents/skills/atomui-gallery-local-debug/scripts/launch-gallery-debug.sh

The launcher builds AtomUIGallery.Desktop, directly executes the current checkout's .artifacts binary, verifies its PID command, and prints REPO_ROOT, BINARY, PID, and LOG. Keep that launcher command running during visual inspection; it waits on the Gallery so command runners cannot reap a detached GUI process.

If an unrecorded process already runs from that exact path, the launcher reports EXISTING_PID and stops without overwriting its PID file. Close or explicitly terminate that verified process before retrying so a stale loaded assembly cannot be mistaken for the new build.

Treat the printed BINARY and PID as the only valid runtime identity. Before visual inspection, confirm the PID still resolves to BINARY.

For Computer Use, connect with the printed absolute executable path:

javascript
let galleryApp = await cua.getApp("<BINARY>");

If exact-path connection fails, stop visual automation and report the limitation. Do not fall back to AtomUIGallery, AtomUI Desktop Gallery, net.atomui.gallery, open, or an .app under /Applications or /Volumes.

After connecting, inspect the accessibility tree or screenshot and confirm the requested current-checkout content is present before interacting further.

Options

CommandUse
launch-gallery-debug.shBuild Debug and start the verified binary.
launch-gallery-debug.sh --no-buildStart an already-built Debug binary.
launch-gallery-debug.sh --configuration ReleaseBuild and start Release.
launch-gallery-debug.sh --dry-run --no-buildPrint resolved identities without building or starting.
launch-gallery-debug.sh --stopStop only the PID previously recorded by this checkout after verifying its path.

When a command tool returns a live session identifier, retain it until inspection finishes. Run --stop separately, then drain the original session.

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

Verification

After changing the Skill, run:

bash
bash .agents/skills/atomui-gallery-local-debug/tests/test-launcher-contract.sh

Completion Contract

  • Build succeeds for the requested configuration.
  • BINARY is inside the current git rev-parse --show-toplevel directory.
  • The launched PID's command begins with the exact BINARY path.
  • UI automation uses that path or stops; a matching display name or bundle ID is not proof.
  • Cleanup affects only the verified PID stored under this checkout's .artifacts/run directory.

Common Mistakes

MistakeRequired response
dotnet run succeeded, so any same-name window is assumed correct.Verify the process executable path; build success does not identify the automated window.
Bundle ID lookup reports ambiguity, then application name is used instead.Stop. Both identifiers use LaunchServices and can select an installed or mounted copy.
Exact-path UI binding is unavailable.Report visual verification as blocked; keep build and automated test evidence separate.
An old PID file points to another process.Refuse to signal it; the launcher must match the recorded PID command to the current BINARY.
An unrecorded current-path process is already running.Report its PID and stop before overwriting the PID file or starting a possibly stale duplicate.

© 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

SKILL.md and 3 other files (scripts) in .agents/skills/atomui-gallery-local-debug of AtomUI/AtomUI.

  • SKILL.md
  • agents/openai.yaml
  • scripts/launch-gallery-debug.sh
  • tests/test-launcher-contract.sh

Open the folder on GitHubat commit d234fe0

Compare with similar skills

Atomui Gallery Local Debug 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.

Atomui Gallery Local Debug compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Atomui Gallery Local Debug this skillAtomUI/AtomUI842—~983Automated safety check: PassLGPL-3.0
Trellis Session Insightmindfold-ai/Trellis15k4 repos~1.7kAutomated safety check: PassAGPL-3.0
Native Data FetchingCherryHQ/cherry-studio-app4k6 repos~2.9kAutomated safety check: NotesMIT
Aoti Debugpytorch/pytorch104k1 repos~1.7kAutomated safety check: PassCustom licence
Herdr Throwaway Reproductionherdrdev/herdr43k—~2.4kAutomated safety check: PassApache-2.0
Systematic Debuggingultralisp/ultralisp25851 repos~2.4kAutomated safety check: PassNone

Similar skills

  • Trellis Session Insight

    mindfold-ai/Trellis

    Reach into past AI conversation history through the trellis mem CLI.

    15k GitHub starsUsed in 4 repos~1.7k tokens
    DevelopmentAuto-check passed
  • Native Data Fetching

    CherryHQ/cherry-studio-app

    A skill your agent uses when implementing or debugging ANY network request, API call, or data fetching.

    4k GitHub starsUsed in 6 repos~2.9k tokens
    DevelopmentAuto-check: notes
  • Aoti Debug

    pytorch/pytorch

    Debug AOTInductor (AOTI) errors and crashes. An agent skill from pytorch/pytorch.

    104k GitHub starsUsed in 1 repo~1.7k tokens
    DevelopmentAuto-check passed
  • Runs a disposable, uniquely named Herdr session inside an existing one so runtime, pane, terminal or API bugs can be reproduced without touching the main session.

    43k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Systematic Debugging

    ultralisp/ultralisp

    A skill your agent uses when encountering any bug, test failure, or unexpected behavior, before proposing fixes

    258 GitHub starsUsed in 51 repos~2.4k tokens
    DevelopmentAuto-check passed
  • Decides whether an OpenLogi device problem on macOS is a privacy-permission (TCC) problem, using agent log lines, and says which identity needs which grant.

    23k GitHub stars~2.5k tokensUpdated 4 days ago
    DevelopmentAuto-check: notes

More from AtomUI/AtomUI

All 15 skills in this repo
  • 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
  • Version Release

    AtomUI/AtomUI

    A skill your agent uses when preparing or validating an AtomUI release, including version-scope confirmation, AtomUIVersion consistency, README version sync, CHANGELOG and Chinese release sections…

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

Categories

Questions about Atomui Gallery Local Debug

What does Atomui Gallery Local Debug do?

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…. Atomui Gallery Local Debug is an agent skill from AtomUI/AtomUI.Desktop from an AtomUI checkout where installed or mounted Gallery apps may share its name or bundle identifier.

When should I use Atomui Gallery Local Debug?

Atomui Gallery Local Debug fits situations like: visually inspecting AtomUIGallery.Desktop from an AtomUI checkout where installed; mounted Gallery apps may share its name; bundle identifier.

How do I install Atomui Gallery Local Debug in Claude Code?

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

How do I install Atomui Gallery Local Debug in Codex?

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

Can I use Atomui Gallery Local Debug 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 atomui-gallery-local-debug -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/atomui-gallery-local-debug, .gemini/skills/atomui-gallery-local-debug, .github/skills/atomui-gallery-local-debug and .opencode/skills/atomui-gallery-local-debug in your project.

What does Atomui Gallery Local Debug need to run?

Going by SKILL.md and its folder, Atomui Gallery Local Debug needs a shell for the scripts in its folder and the command-line tools its instructions call (bash, git and dotnet). Our summary lists: A Bash shell.

Does Atomui Gallery Local Debug 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 Atomui Gallery Local Debug 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Atomui Gallery Local Debug use?

Atomui Gallery Local Debug 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 Atomui Gallery Local Debug use?

About 983 tokens (SKILL.md is roughly 3.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 Atomui Gallery Local Debug?

Skills that share tags, products or a category with Atomui Gallery Local Debug: Trellis Session Insight (mindfold-ai/Trellis, 15k stars), Native Data Fetching (CherryHQ/cherry-studio-app, 4k stars), Aoti Debug (pytorch/pytorch, 104k stars) and Herdr Throwaway Reproduction (herdrdev/herdr, 43k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Atomui Gallery Local Debug?

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.