Agent skill

Desktop Principles

by AThevon in AThevon/genjutsu

Desktop-specific UX principles - hover states, pointer precision, keyboard shortcuts, multi-window, focus management.

Custom licenceAuto-check passedFrontend & Design

Install Desktop Principles

skills CLI
$ npx skills add AThevon/genjutsu --skill desktop-principles -a claude-code

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

GitHub CLI
$ gh skill install AThevon/genjutsu desktop-principles --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/AThevon/genjutsu.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/_jutsu/desktop-principles .claude/skills/desktop-principles && 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
desktop-principles
GitHub stars
424
Used in
1 other repo
Token cost
~3.3k tokens
SKILL.md length
832 words
Files
3 (incl. references)
Skills in repo
20
Repo updated
First seen
Licence
Custom licence

At a glance

Desktop-specific UX principles - hover states, pointer precision, keyboard shortcuts, multi-window, focus management.

  • Works in 3 steps: Hiding navigation behind a hamburger on… → No keyboard shortcuts for primary actions → Removing focus rings without an…
  • Frontend & Design work in your project
  • SKILL.md covers Hover States Are Mandatory, Pointer Precision, Keyboard Shortcuts (first-class) and Multi-Window Patterns, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Desktop Principles is an agent skill from AThevon/genjutsu. Desktop-specific UX principles - hover states, pointer precision, keyboard shortcuts, multi-window, focus management. Covers macOS, Windows, Linux, web desktop.

Its SKILL.md is about 3.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/keyboard-patterns.md` and `references/multi-window.md`).

It sits in Frontend & Design. It works with macOS, Linux and iOS. The repository describes itself as: Creative coding skills for Claude Code, claude.ai and Cowork. Motion, micro-interactions and design systems across Web (GSAP, Motion, Three.js, CSS), Android (Jetpack Compose)…

When your agent uses it

  • Frontend & Design work in your project

Example prompts

  • “/desktop-principles”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Hiding navigation behind a hamburger on desktop
  2. No keyboard shortcuts for primary actions
  3. Removing focus rings without an alternative

What it can do on your machine

Read from SKILL.md and the folder at commit 1f518a7. 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 css, swift, kotlin, javascript and html).

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

  • Network

    Links to these hosts (documentation or services it may open):

    • developer.apple.com
    • fluent2.microsoft.design
    • developer.gnome.org

    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

Desktop Principles loads about 3.3k tokens when it runs, and up to ~6.6k if it reads all its reference files. Until then it costs about 45 tokens; SKILL.md has 832 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 832 words (~3,348 tokens).

“Hover is the primary affordance signal on desktop, the inverse of mobile. A pointer hovering over a target without immediate visual feedback feels broken: users rely on :hover to confirm an element is interactive before committing to a click. Every…”

— opening of SKILL.md by AThevon, Custom licence
name
desktop-principles
metadata.internal
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (references) in skills/_jutsu/desktop-principles of AThevon/genjutsu.

  • SKILL.md
  • references/keyboard-patterns.md
  • references/multi-window.md

Open the folder on GitHubat commit 1f518a7

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in AThevon/genjutsu, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Desktop Principles 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.

Desktop Principles compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Desktop Principles this skillAThevon/genjutsu4241 repos~3.3kAutomated safety check: PassCustom licence
AccessibilityVeryGoodOpenSource/vgv-ai-flutter-plugin169—~4.2kAutomated safety check: PassMIT
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
OdevioOdevio/Odevio-CLI423—~7.6kAutomated safety check: PassMIT
Jetpack Composedarriousliu/PiPixiv262—~1.5kAutomated safety check: PassApache-2.0
Ccapwysaid/CameraCapture191—~1.4kAutomated safety check: PassMIT

Similar skills

  • Accessibility

    VeryGoodOpenSource/vgv-ai-flutter-plugin

    Audits or remediates Flutter widgets against WCAG 2.2 conformance levels A, AA, or AAA across iOS, Android, Web, macOS, Windows, and Linux, covering Semantics labels and screen reader output under…

    169 GitHub stars~4.2k tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • Odevio

    Odevio/Odevio-CLI

    Take a Flutter project to an iPhone or the App Store with Odevio - build, sign and publish iOS apps from Windows, Linux or macOS with no Mac and no Xcode.

    423 GitHub stars~7.6k tokensUpdated 14 days ago
    MobileAuto-check passed
  • Jetpack Compose

    darriousliu/PiPixiv

    Jetpack Compose expert skill for Android UI development. An agent skill from darriousliu/PiPixiv.

    262 GitHub stars~1.5k tokensUpdated today
    MobileAuto-check passed
  • Ccap

    wysaid/CameraCapture

    Install or use the ccap CLI for camera capture, webcam inspection, device listing, frame capture, and video metadata.

    191 GitHub stars~1.4k tokensUpdated 3 mo ago
    MobileAuto-check passed
  • Maui AI Debugging

    Redth/Maui.Gtk

    End-to-end workflow for building, deploying, inspecting, and debugging .NET MAUI and MAUI Blazor Hybrid apps as an AI agent.

    101 GitHub stars~4.1k tokensUpdated 5 mo ago
    MobileAuto-check passed

More from AThevon/genjutsu

All 20 skills in this repo
  • Orchestration

    AThevon/genjutsu

    Running a team of subagents on one design build: clone briefs, disjoint file ownership, isolated builds, the evidence packet, review lenses, the fix plan, verdicts, cold eyes and the stop rule, with…

    424 GitHub stars~4.9k tokensUpdated 2 days ago
    Auto-check passed
  • Swiftui Graphics

    AThevon/genjutsu

    Advanced SwiftUI visuals - Metal shaders (.colorEffect, .layerEffect, .distortionEffect), .visualEffect, Liquid Glass (iOS 26), Canvas, holographic and CRT effects.

    424 GitHub starsUsed in 2 repos~3.5k tokens
    Auto-check passed
  • Design Audit

    AThevon/genjutsu

    Design audit checklist - motion gaps, accessibility, color consistency, responsive, performance.

    424 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • UI UX Pro Max

    AThevon/genjutsu

    UI/UX design-system intelligence - 84 styles, 192 palettes, 74 font pairings, 25 charts, 99 UX guidelines across 22 stacks (searchable dataset + CLI).

    424 GitHub stars~4.3k tokensUpdated 2 days ago
    Auto-check passed
  • Canvas Generative

    AThevon/genjutsu

    Algorithmic and generative art with Canvas 2D - particles, flow fields, noise, fractals, L-systems.

    424 GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Compose Motion

    AThevon/genjutsu

    Jetpack Compose animation foundations - animateAsState, AnimatedVisibility, Crossfade, updateTransition, SharedTransitionLayout, gestures.

    424 GitHub starsUsed in 1 repo~3.5k tokens
    Auto-check passed

Works with

Questions about Desktop Principles

What does Desktop Principles do?

Desktop-specific UX principles - hover states, pointer precision, keyboard shortcuts, multi-window, focus management. Desktop Principles is an agent skill from AThevon/genjutsu. Desktop-specific UX principles - hover states, pointer precision, keyboard shortcuts, multi-window, focus management.

When should I use Desktop Principles?

Desktop Principles fits situations like: frontend & Design work in your project.

How do I install Desktop Principles in Claude Code?

Run `npx skills add AThevon/genjutsu --skill desktop-principles -a claude-code`. Or copy the skill folder (skills/_jutsu/desktop-principles in AThevon/genjutsu) into .claude/skills/desktop-principles in your project. Claude Code loads it when a task matches its description.

How do I install Desktop Principles in Codex?

Run `npx skills add AThevon/genjutsu --skill desktop-principles -a codex`. Or copy the skill folder (skills/_jutsu/desktop-principles in AThevon/genjutsu) into .agents/skills/desktop-principles in your project. Codex loads it when a task matches its description.

Can I use Desktop Principles 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 AThevon/genjutsu --skill desktop-principles -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/desktop-principles, .gemini/skills/desktop-principles, .github/skills/desktop-principles and .opencode/skills/desktop-principles in your project.

What does Desktop Principles need to run?

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

Does Desktop Principles access the network?

SKILL.md names 3 domains. As links in the text: developer.apple.com, fluent2.microsoft.design and developer.gnome.org. This is read from the text; nothing was executed.

Is Desktop Principles 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 Desktop Principles use?

Desktop Principles has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Desktop Principles use?

About 3.3k tokens (SKILL.md is roughly 13k 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 3.3k tokens, read only when the agent opens those files.

What are the alternatives to Desktop Principles?

Skills that share tags, products or a category with Desktop Principles: Accessibility (VeryGoodOpenSource/vgv-ai-flutter-plugin, 169 stars), Engine Whats New (flutter/flutter, 179k stars), Odevio (Odevio/Odevio-CLI, 423 stars) and Jetpack Compose (darriousliu/PiPixiv, 262 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Desktop Principles?

AThevon (a GitHub user) maintains it in AThevon/genjutsu, which has 424 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 5, 2026.

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