Agent skill

Steamdeck UI Design

by jinzhongjia in jinzhongjia/decky-music

Project-specific Steam Deck Game Mode UI rules for decky-music.

MITAuto-check passedFrontend & Design

Install Steamdeck UI Design

skills CLI
$ npx skills add jinzhongjia/decky-music --skill steamdeck-ui-design -a claude-code

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

GitHub CLI
$ gh skill install jinzhongjia/decky-music steamdeck-ui-design --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/jinzhongjia/decky-music.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/steamdeck-ui-design .claude/skills/steamdeck-ui-design && 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
steamdeck-ui-design
GitHub stars
122
Token cost
~1.1k tokens
SKILL.md length
571 words
Files
2 (incl. references)
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Project-specific Steam Deck Game Mode UI rules for decky-music.

  • Reviewing the /music Decky route
  • SKILL.md covers Project source of truth, Core layout contract, Focus and gamepad contract and Visual contract, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • QAM entry points

What it does

Steamdeck UI Design is an agent skill from jinzhongjia/decky-music. Project-specific Steam Deck Game Mode UI rules for decky-music. Use when designing, implementing, or reviewing the /music Decky route, provider pages, QAM entry points, gamepad focus behavior, Footer Legend text, or UI mockups.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/official-ui-analysis.md`).

It sits in Frontend & Design, covering UI design. The repository describes itself as: Steam decky plugin for music(QQ Music and NetEase Cloud Music). The licence is MIT.

When your agent uses it

  • Reviewing the /music Decky route
  • QAM entry points
  • Gamepad focus behavior
  • Footer Legend text

Example prompts

  • “/steamdeck-ui-design”

What it can do on your machine

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

Steamdeck UI Design loads about 1.1k tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 571 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.1k

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 jinzhongjia/decky-music at commit 152c9c8, republished under its MIT licence (© jinzhongjia). 571 words, ~1,123 tokens.

Download SKILL.mdSave it as .claude/skills/steamdeck-ui-design/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
steamdeck-ui-design
description
Project-specific Steam Deck Game Mode UI rules for decky-music. Use when designing, implementing, or reviewing the `/music` Decky route, provider pages, QAM entry points, gamepad focus behavior, Footer Legend text, or UI mockups.

Steam Deck UI Design for decky-music

Use this project-specific skill for decky-music UI work.

Project source of truth

Read these before changing UI behavior:

  • docs/DESIGN.md §6: architecture-level UI constraints.
  • docs/ui-design/specs/steam-deck-ui-rules.md: shared visual, focus, button, Footer Legend, and host-safety contract.
  • docs/ui-design/specs/qq-ui.md: QQ provider page rules.
  • docs/ui-design/specs/ncm-ui.md: NCM provider page rules.
  • docs/ROADMAP.md: current P3+ implementation order.

Core layout contract

  • /music uses top horizontal provider Tabs and full-width content.
  • QQ pages: 推荐 / 搜索 / 我的音乐 / 智能电台 / 正在播放.
  • NCM pages: 发现 / 私人 FM / 搜索 / 我的 / 正在播放.
  • SteamOS global chrome is system-owned: search, notifications, Wi-Fi, battery, time, avatar. Do not draw or focus it.
  • Put provider logo, top Tabs, L1/R1 hints, and the current-track status badge in the content header row.
  • Personal asset pages use the Steam library pattern: second-level Tabs with counts plus full-width list/grid content.
  • Search pages must survive soft-keyboard resize without overlapping or fixed-bottom controls.
  • Do not add persistent sidebars inside /music.
  • Footer Legend is system-rendered through Focusable action descriptions; never draw a footer bar.
  • Do not add a fixed bottom MiniPlayer. Use the status badge, queue overlay, and Now Playing pages.

Focus and gamepad contract

Every interactive element must be reachable by gamepad focus.

Buttondecky-music meaning
AConfirm, play, enter detail, submit search, refresh QR.
BBack, close overlay, cancel manual lyric/comment browsing.
XContext menu; NCM lyrics/comment toggle; radio page may override for trash/next.
YQueue overlay on normal pages; radio pages may override for like/favorite.
StartGlobal play/pause blind operation. Hide the hint when queue is empty or backend is unavailable.
ViewReserved; do not use for required flows.
L1/R1Top-level provider page switching.
L2/R2Secondary Tabs or long-list paging.
D-Pad / left stickFocus roaming; lyrics manual scroll; slider micro-adjustment.
Steam / QAMSystem reserved, never bind.

Hard rules:

  • Wrap all clickable rows, cards, buttons, and sliders in Focusable or a Decky component that participates in the focus tree.
  • Use MAINTAIN_X for grids and multi-column layouts.
  • No hover-only, touch-only, hidden click zones, or pointer-only affordances.
  • Overlays have their own focus tree and restore the previous focus on close.
  • Footer Legend text must match the current focus and mode in the same state update.
Show full SKILL.md (218 more words)Show less

Visual contract

  • Use near-black SteamOS-style backgrounds.
  • Use Steam blue #1a9fff as the main interaction color.
  • Use QQ green / NCM red only for brand accents and like-state highlights.
  • Cover art is the card; avoid phone-app rounded containers.
  • Focus state: thin white outline close to the element, subtle glow/scale.
  • List focus: horizontal grey gradient with optional Steam-blue left rail.
  • Cover images load from CDN thumbnails with an onError placeholder; never send image bytes through bridge RPC.

Host-safety contract

Steam UI and plugin UI share one Chromium context. A plugin bug must not freeze Steam.

  • Catch all async handlers, timers, RPC calls, and event callbacks.
  • Treat malformed backend events as data to ignore, not as render-time assumptions.
  • Limit list rendering with pagination or virtualization.
  • Clean timers, event listeners, routes, and overlays on unmount.
  • Do not monkey-patch Steam globals or write project globals.
  • Do not expose URL, cookie, credential, or raw provider secrets to UI logs.

Verification checklist

Before considering UI work done:

  • Pure gamepad flow works: enter /music, switch Tabs, search/open content, play, pause/resume, open/close queue, open/close context menu.
  • Soft keyboard does not push a fixed player bar over content.
  • Footer Legend shows only currently executable actions.
  • Backend down, malformed data, empty lists, and network errors render recoverable states.
  • Steam UI remains responsive; worst case only decky-music shows an error boundary.

© jinzhongjia, MIT. 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 1 other file (references) in .agents/skills/steamdeck-ui-design of jinzhongjia/decky-music.

  • SKILL.md
  • references/official-ui-analysis.md

Open the folder on GitHubat commit 152c9c8

Compare with similar skills

Steamdeck UI Design 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.

Steamdeck UI Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Steamdeck UI Design this skilljinzhongjia/decky-music122—~1.1kAutomated safety check: PassMIT
UI StylingOhh-889/skyroc79513 repos~2.5kAutomated safety check: PassMIT
LobeHub Interactive Prototypelobehub/lobehub83k—~1.6kAutomated safety check: PassCustom licence
Make Interfaces Feel Bettersamuelclay/NewsBlur7.6k10 repos~1.5kAutomated safety check: PassMIT
UI UX Pro MaxZxBing0066/pixel-converter18113 repos~2.6kAutomated safety check: NotesBSD-2-Clause
Design Dnazanwei/design-dna1.9k1 repos~2.1kAutomated safety check: PassMIT

Similar skills

  • UI Styling

    Ohh-889/skyroc

    Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs.

    795 GitHub starsUsed in 13 repos~2.5k tokens
    Frontend & DesignAuto-check passed
  • Builds single-file interactive HTML prototypes rendered with the real LobeHub UI components and written as production-style React, so they can later be split into files.

    83k GitHub stars~1.6k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Make Interfaces Feel Better

    samuelclay/NewsBlur

    Design engineering principles for making interfaces feel polished.

    7.6k GitHub starsUsed in 10 repos~1.5k tokens
    Frontend & DesignAuto-check passed
  • UI UX Pro Max

    ZxBing0066/pixel-converter

    UI/UX design intelligence with searchable database. An agent skill from ZxBing0066/pixel-converter.

    181 GitHub starsUsed in 13 repos~2.6k tokens
    Frontend & DesignAuto-check: notes
  • Design Dna

    zanwei/design-dna

    Extract, define, and apply design DNA across three dimensions: design system (tokens), design style (qualitative feel), and visual effects (Canvas, WebGL, 3D, particles, shaders, scroll effects…

    1.9k GitHub starsUsed in 1 repo~2.1k tokens
    Frontend & DesignAuto-check passed
  • Figma Design to Code

    warpdotdev/warp

    Turns a Figma frame or component into production code that matches the design, using the Figma MCP server and the project's own design system.

    65k GitHub starsUsed in 4 repos~2.9k tokens
    Frontend & DesignAuto-check passed

More from jinzhongjia/decky-music

  • Steam Cdp

    jinzhongjia/decky-music

    Drive and inspect the running Steam client UI over the Chrome DevTools Protocol (CEF remote debugging, port 8080) — list targets, evaluate JS probes, navigate routes, click elements, dispatch keys…

    122 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Decky Dev

    jinzhongjia/decky-music

    Autonomous develop-deploy-debug loop for Steam Deck Decky Loader plugins — sideload deploys, log pulling, CEF/CDP automation of the running Steam UI (navigate, click, screenshot, key input), sleep…

    122 GitHub stars~1.3k tokensUpdated today
    Auto-check: notes
  • Release

    jinzhongjia/decky-music

    发布 decky-music 新版本(pre-release 或正式)。当用户说"发版 / 发布新版本 / pre-release / 发 beta"时使用。覆盖版本号、二进制构建、remotebinary 指纹、tag、GitHub Release、CI 出包、zip 抽验,以及正式发布后向 Steam Deck 下载目录交付普通/full/CN 三个安装包的完整流程。

    122 GitHub stars~1.3k tokensUpdated today
    Auto-check: notes
  • Pending Verify Issue

    jinzhongjia/decky-music

    把"已提交但尚未真机验证"的改动登记成 GitHub issue,避免未验收当已完成。当改动触碰 AGENTS.md 要求真机验收的运行时/UI 行为,但验证被阻塞(没拿到部署授权、或用户选择先提交后验证)时使用。

    122 GitHub stars~334 tokensUpdated today
    Auto-check passed

Questions about Steamdeck UI Design

What does Steamdeck UI Design do?

Project-specific Steam Deck Game Mode UI rules for decky-music. Steamdeck UI Design is an agent skill from jinzhongjia/decky-music. Project-specific Steam Deck Game Mode UI rules for decky-music.

When should I use Steamdeck UI Design?

Steamdeck UI Design fits situations like: reviewing the /music Decky route; QAM entry points; gamepad focus behavior; footer Legend text.

How do I install Steamdeck UI Design in Claude Code?

Run `npx skills add jinzhongjia/decky-music --skill steamdeck-ui-design -a claude-code`. Or copy the skill folder (.agents/skills/steamdeck-ui-design in jinzhongjia/decky-music) into .claude/skills/steamdeck-ui-design in your project. Claude Code loads it when a task matches its description.

How do I install Steamdeck UI Design in Codex?

Run `npx skills add jinzhongjia/decky-music --skill steamdeck-ui-design -a codex`. Or copy the skill folder (.agents/skills/steamdeck-ui-design in jinzhongjia/decky-music) into .agents/skills/steamdeck-ui-design in your project. Codex loads it when a task matches its description.

Can I use Steamdeck UI Design 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 jinzhongjia/decky-music --skill steamdeck-ui-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/steamdeck-ui-design, .gemini/skills/steamdeck-ui-design, .github/skills/steamdeck-ui-design and .opencode/skills/steamdeck-ui-design in your project.

What does Steamdeck UI Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Steamdeck UI Design is instructions for the agent only.

Does Steamdeck UI Design 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 Steamdeck UI Design 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 Steamdeck UI Design use?

Steamdeck UI Design 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 Steamdeck UI Design use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1k tokens, read only when the agent opens those files.

What are the alternatives to Steamdeck UI Design?

Skills that share tags, products or a category with Steamdeck UI Design: UI Styling (Ohh-889/skyroc, 795 stars), LobeHub Interactive Prototype (lobehub/lobehub, 83k stars), Make Interfaces Feel Better (samuelclay/NewsBlur, 7.6k stars) and UI UX Pro Max (ZxBing0066/pixel-converter, 181 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Steamdeck UI Design?

jinzhongjia (a GitHub user) maintains it in jinzhongjia/decky-music, which has 122 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 10, 2026.

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