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