Agent skill

Zoonk Design

by zoonk in zoonk/zoonk

Design, implement, or assess Zoonk interfaces with clear hierarchy, low cognitive effort, and a coherent visual language.

MITAuto-check passed

Install Zoonk Design

skills CLI
$ npx skills add zoonk/zoonk --skill zoonk-design -a claude-code

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

GitHub CLI
$ gh skill install zoonk/zoonk zoonk-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/zoonk/zoonk.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/zoonk-design .claude/skills/zoonk-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
zoonk-design
GitHub stars
157
Token cost
~1.3k tokens
SKILL.md length
664 words
Files
2 (incl. references)
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Design, implement, or assess Zoonk interfaces with clear hierarchy, low cognitive effort, and a coherent visual language.

  • SKILL.md covers Understand the task, Shape the experience, Zoonk's visual language and Check the experience, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Zoonk Design is an agent skill from zoonk/zoonk. Design, implement, or assess Zoonk interfaces with clear hierarchy, low cognitive effort, and a coherent visual language.

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

The repository describes itself as: Turn any topic into clear, structured lessons. The licence is MIT.

Example prompts

  • “/zoonk-design”

What it can do on your machine

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

Zoonk Design loads about 1.3k tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 34 tokens; SKILL.md has 664 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
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 zoonk/zoonk at commit d6d96be, republished under its MIT licence (© zoonk). 664 words, ~1,318 tokens.

Download SKILL.mdSave it as .claude/skills/zoonk-design/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
zoonk-design
description
Design, implement, or assess Zoonk interfaces with clear hierarchy, low cognitive effort, and a coherent visual language.
license
MIT
metadata.author
zoonk
metadata.version
3.0.0

Zoonk design

Build clean, subtle, harmonious interfaces. Don't make me think: make the purpose, available actions, and their consequences easy to understand. Reduce the effort of using the interface while preserving the thought that learning requires. The user's explicit requirements take precedence over this skill.

Understand the task

Start with the person's goal, knowledge, and context. Identify what they need to decide and what the product can handle for them. Choose the structure before the controls; a feature list is not an interface.

Inspect relevant screens and shared components in the current main app. Match established controls, proportions, and behavior in mockups as well as code. Question patterns that make the task harder. When the structure is uncertain, prototype with representative content before polishing.

Shape the experience

  • Resolve unnecessary decisions. Provide a useful default path. Use known context and reversible defaults; ask people to choose where their preferences or circumstances matter.
  • Give attention a clear order. Decide what matters now, what supports it, and what can wait. Make the next action obvious; keep alternatives available without giving every option equal emphasis. Reconsider competing elements before fitting them into a tidier layout.
  • Make each element earn its place. Remove labels that restate the obvious and repeated representations of the same information. Before adding a separate widget, consider whether an existing element can communicate it naturally. Look for simpler combinations of information and action while keeping their meaning clear.
  • Organize complexity around the task. Sequence decisions when one answer determines what comes next. Keep related information together when people need to compare it. Reveal infrequent detail on demand through discoverable controls. Judge total effort: extra steps and hidden information can create more work.
  • Make behavior predictable. Use familiar concepts, specific labels, and consistent interactions. Keep needed context visible. If routine use needs lengthy explanation, improve the interaction; place necessary guidance where uncertainty occurs.
  • Build confidence. Show state and feedback promptly. Prevent likely mistakes, preserve work, and make correction easy. Keep meaningful choices accessible.
  • Design the whole journey. Preserve context and consistent placement across transitions. Each addition should fit the surrounding experience. Reusing components alone does not make a coherent interface.
  • Express care. Make people feel capable and comfortable through thoughtful language, balanced proportions, responsive feedback, and smooth continuity. Delight should remain pleasant through repeated use.

For the reasoning behind these principles, see Design foundations.

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

Zoonk's visual language

  • Keep company logos out of app interfaces; use that space for the person's task.
  • Use shared alignment anchors across adjacent sections and columns. Group through spacing and typography; add dividers or containers only when the grouping remains unclear without them.
  • Use a neutral base with purposeful color, including icons that help distinguish content. Establish hierarchy through size, weight, and tone: contextual labels stay smaller and quieter than the content they introduce. Keep text readable and controls distinct.
  • Reuse @zoonk/ui components and established variants. Check existing primitives and the shadcn registry before building a missing web primitive. Use Tailwind utilities and semantic tokens.
  • Follow established button variants for the task: default for the primary action, outline for ordinary actions, and secondary for modest emphasis. Preserve compact proportions and familiar content placement. Keep text navigation lightweight.
  • Write concise, concrete copy with enough context to remove uncertainty. Use imagery and subtle motion to communicate or support the experience; respect reduced-motion preferences.

Check the experience

Walk through the task: can someone recognize what matters, predict what happens next, and recover from mistakes? Check what can be removed or combined without losing clarity. Fix unnecessary interpreting, remembering, and choosing.

Inspect implemented changes in the running app at relevant sizes. Check affected loading, empty, disabled, and error states, plus keyboard access, focus, touch targets, long translations, and dark mode where relevant. Recheck observed friction. For proposals, show representative screens and transitions. State what remains unverified.

Follow native platform conventions over web-specific styling.

© zoonk, 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/zoonk-design of zoonk/zoonk.

  • SKILL.md
  • references/design-foundations.md

Open the folder on GitHubat commit d6d96be

Compare with similar skills

Zoonk 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.

Zoonk Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Zoonk Design this skillzoonk/zoonk157—~1.3kAutomated safety check: PassMIT
Implementing Device Posture Assessment In Zero Trustmukul975/Anthropic-Cybersecurity-Skills34k—~4.1kAutomated safety check: PassApache-2.0
Implementsickn33/agentic-awesome-skills47k5 repos~306Automated safety check: PassMIT
Implementcodewhale-hq/Codewhale41k—~190Automated safety check: PassMIT
Implement Changepnpm/pnpm37k—~1.1kAutomated safety check: PassMIT
Incremental Implementationaddyosmani/agent-skills103k1 repos~2.3kAutomated safety check: PassMIT

Similar skills

  • Implementing Device Posture Assessment In Zero Trust

    mukul975/Anthropic-Cybersecurity-Skills

    Implements device posture assessment as a zero trust access control by integrating endpoint health signals from CrowdStrike ZTA, Microsoft Intune, and Jamf into conditional access policies that…

    34k GitHub stars~4.1k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Implement

    sickn33/agentic-awesome-skills

    Implement a piece of work based on a PRD or set of issues. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 5 repos~306 tokens
    Product & Project ManagementAuto-check passed
  • Implement

    codewhale-hq/Codewhale

    Carry an authorized, defined request or approved plan through scoped edits and proportionate verification.

    41k GitHub stars~190 tokensUpdated today
    Auto-check passed
  • Implement a pnpm feature, bug fix, or refactor by checking existing capabilities, prioritizing code reuse and deduplication, assessing architecture impact, and validating the final change.

    37k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Incremental Implementation

    addyosmani/agent-skills

    Delivers a change in thin vertical slices, each implemented, tested, verified and committed before the next, using vertical, contract-first or risk-first slicing.

    103k GitHub starsUsed in 1 repo~2.3k tokens
    Agent WorkflowsAuto-check passed
  • Implement

    bestofjs/bestofjs

    Implement a piece of work based on a spec or set of tickets.

    3.1k GitHub starsUsed in 18 repos~109 tokens
    Auto-check passed

More from zoonk/zoonk

All 11 skills in this repo
  • Workflow

    zoonk/zoonk

    Creates durable, resumable workflows using Vercel's Workflow DevKit.

    157 GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when designing, reviewing, or implementing Android UI or features for phones, tablets, foldables, ChromeOS, desktop windowing, Wear OS, Android TV, Android for Cars, Android…

    157 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when designing, reviewing, or implementing any Apple-platform UI or feature for iOS, iPadOS, macOS, visionOS, tvOS, watchOS, SwiftUI, UIKit, AppKit, WatchKit, app icons, Dark…

    157 GitHub stars~942 tokensUpdated yesterday
    Auto-check passed
  • Create or update problem-focused Zoonk GitHub issues and their requested metadata or relationships.

    157 GitHub stars~632 tokensUpdated yesterday
    Auto-check passed
  • Zoonk Commit

    zoonk/zoonk

    Write Zoonk commit messages and PR titles or descriptions when preparing a commit or pull request.

    157 GitHub stars~578 tokensUpdated yesterday
    Auto-check passed
  • Create or refactor reusable Zoonk React UI primitives using flat compound components.

    157 GitHub stars~583 tokensUpdated yesterday
    Auto-check passed

Questions about Zoonk Design

What does Zoonk Design do?

Design, implement, or assess Zoonk interfaces with clear hierarchy, low cognitive effort, and a coherent visual language. Zoonk Design is an agent skill from zoonk/zoonk. Design, implement, or assess Zoonk interfaces with clear hierarchy, low cognitive effort, and a coherent visual language.

How do I install Zoonk Design in Claude Code?

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

How do I install Zoonk Design in Codex?

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

Can I use Zoonk 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 zoonk/zoonk --skill zoonk-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/zoonk-design, .gemini/skills/zoonk-design, .github/skills/zoonk-design and .opencode/skills/zoonk-design in your project.

What does Zoonk Design need to run?

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

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

Zoonk Design is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Zoonk Design use?

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

What are the alternatives to Zoonk Design?

Skills that share tags, products or a category with Zoonk Design: Implementing Device Posture Assessment In Zero Trust (mukul975/Anthropic-Cybersecurity-Skills, 34k stars), Implement (sickn33/agentic-awesome-skills, 47k stars), Implement (codewhale-hq/Codewhale, 41k stars) and Implement Change (pnpm/pnpm, 37k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Zoonk Design?

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

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