Kwark. Design System
Open Kwark

Skills

Fourteen downloadable agent skills that teach Claude (and any agent that reads SKILL.md files) to build, review, write copy, hand off, record decisions and start a creative app the Kwark way.

For agents

What a skill is

A skill is a folder with a SKILL.md file: a short name, a description of when to use it, and the instructions. Claude Code reads the description of every installed skill and loads the instructions only when a task matches, so a skill costs almost nothing until it is needed. Other agents can be given a SKILL.md as a plain prompt.

Each Kwark skill is small and points to the hosted pages instead of copying them, so it stays current when the system changes.

The skills

Skill Use it to Loads
kwark-ui Build or change a screen, panel, dialog, menu or component with the system. AGENTS.md, the component and pattern pages it uses
kwark-ux-review Review a screen, screenshot or diff as a review-only supervisor, in Kwark’s order: the person, their work, the system, states, accessibility, copy, look. AGENTS.md, Principles, Review and quality
kwark-ux-copy Write buttons, errors, save states, empty states, confirmations and toasts in Kwark’s voice. UX writing, Content, Errors, Saving and sync, Empty states
kwark-handoff Write a design-to-code spec from a design description. Comes with template.md. Handoff, AGENTS.md, components.json, Phones
kwark-decision-record Write a numbered decision record with Kwark’s template. Decision records, Contributing, Principles
kwark-creative-app Start a new creative or filmmaking app on the system, in the right order. llms.txt, AGENTS.md, Developing, Roadmap, the nearest kit

Product workflows

These eight skills package the product method for a team that has the public system and its own project evidence.

Skill Use it for
kwark-frame-problem Identify the person, artefact, blockage and evidence before choosing a feature.
kwark-map-opportunities Connect an outcome to opportunities, approaches and the next test.
kwark-test-assumptions Test the assumption with the greatest consequence and least evidence.
kwark-prioritise Choose a release slice using effect on the work, dependencies and verification cost.
kwark-write-spec Specify records, states, permissions, recovery and acceptance criteria.
kwark-synthesise-research Turn supplied observations into findings with traceable sources.
kwark-measure-outcome Measure task completion and safety while keeping writing measures private.
kwark-check-release Assess the actual build against the agreed journey and evidence.

To install a product workflow, replace the skill name below with the one you need.

mkdir -p ~/.claude/skills/kwark-frame-problem
curl -fsSL https://kwark.space/designSystem/skills/kwark-frame-problem/SKILL.md -o ~/.claude/skills/kwark-frame-problem/SKILL.md

Install

For you, in every project

for s in kwark-ui kwark-ux-review kwark-ux-copy kwark-handoff kwark-decision-record kwark-creative-app; do
  mkdir -p ~/.claude/skills/$s
  curl -fsSL https://kwark.space/designSystem/skills/$s/SKILL.md -o ~/.claude/skills/$s/SKILL.md
done
curl -fsSL https://kwark.space/designSystem/skills/kwark-handoff/template.md -o ~/.claude/skills/kwark-handoff/template.md

For a team, in one repository

The same loop with .claude/skills/ instead of ~/.claude/skills/, run from the repository root. Commit the folder so everyone who opens the project gets the same skills.

for s in kwark-ui kwark-ux-review kwark-ux-copy kwark-handoff kwark-decision-record kwark-creative-app; do
  mkdir -p .claude/skills/$s
  curl -fsSL https://kwark.space/designSystem/skills/$s/SKILL.md -o .claude/skills/$s/SKILL.md
done
curl -fsSL https://kwark.space/designSystem/skills/kwark-handoff/template.md -o .claude/skills/kwark-handoff/template.md

Install only the ones you need; each works alone. Restart Claude Code, or start a new session, to pick them up. Ask “which skills do you have?” to check.

In other agents

  • Cursor: save a SKILL.md as a rule in .cursor/rules/ (rename it .mdc), and set it to apply when relevant.
  • Codex: add the skill’s instructions as a section of the repository’s AGENTS.md, or paste it at the start of the task.
  • Gemini: add it to GEMINI.md, or paste it at the start of the conversation.

Using them

Name the skill when you want a specific one, or describe the task and let the agent choose:

  • “Use kwark-ui to add the Rename scene dialog.”
  • “Review this diff with kwark-ux-review. Don’t change anything.”
  • “kwark-ux-copy: the import reached this device but not the cloud. What does the toast say?”
  • “Write the handoff for the call sheet’s Issue action with kwark-handoff.”
  • “Record why phones get one floating control, using kwark-decision-record.”
  • “We’re starting a sound-mixing app. Set it up with kwark-creative-app.”

The skills work best with the MCP server installed: they tell the agent to use get_component, get_tokens and audit_code when they are available.

When a Kwark skill is active, follow its Load first list before writing anything, and its Rules over any default you would otherwise use. If a page the skill names cannot be fetched, say so and continue with AGENTS.md; do not reconstruct the page from memory.

AI readiness test

Task. Install the Kwark review and copy skills for a team repository and show how a reviewer would use them on a pull request.

Give the agent. This page.

Constraint. Project-level install only. Use the URLs on this page.

A reliable answer

  • Installs into .claude/skills in the repository and commits the folder
  • Fetches SKILL.md for kwark-ux-review and kwark-ux-copy
  • Names the skill in the request
  • Keeps the review read-only
  • Mentions the MCP server as optional, not required

Give this Markdown to your coding agent or share its URL.

Open .mdllms.txt
Loading…