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

Source: https://kwark.space/designSystem/agents/skills

## 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`](https://kwark.space/designSystem/skills/kwark-ui/SKILL.md) | 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`](https://kwark.space/designSystem/skills/kwark-ux-review/SKILL.md) | 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`](https://kwark.space/designSystem/skills/kwark-ux-copy/SKILL.md) | 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`](https://kwark.space/designSystem/skills/kwark-handoff/SKILL.md) | Write a design-to-code spec from a design description. Comes with [`template.md`](https://kwark.space/designSystem/skills/kwark-handoff/template.md). | Handoff, AGENTS.md, components.json, Phones |
| [`kwark-decision-record`](https://kwark.space/designSystem/skills/kwark-decision-record/SKILL.md) | Write a numbered decision record with Kwark's template. | Decision records, Contributing, Principles |
| [`kwark-creative-app`](https://kwark.space/designSystem/skills/kwark-creative-app/SKILL.md) | 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](https://kwark.space/designSystem/skills/kwark-frame-problem/SKILL.md) | Identify the person, artefact, blockage and evidence before choosing a feature. |
| [kwark-map-opportunities](https://kwark.space/designSystem/skills/kwark-map-opportunities/SKILL.md) | Connect an outcome to opportunities, approaches and the next test. |
| [kwark-test-assumptions](https://kwark.space/designSystem/skills/kwark-test-assumptions/SKILL.md) | Test the assumption with the greatest consequence and least evidence. |
| [kwark-prioritise](https://kwark.space/designSystem/skills/kwark-prioritise/SKILL.md) | Choose a release slice using effect on the work, dependencies and verification cost. |
| [kwark-write-spec](https://kwark.space/designSystem/skills/kwark-write-spec/SKILL.md) | Specify records, states, permissions, recovery and acceptance criteria. |
| [kwark-synthesise-research](https://kwark.space/designSystem/skills/kwark-synthesise-research/SKILL.md) | Turn supplied observations into findings with traceable sources. |
| [kwark-measure-outcome](https://kwark.space/designSystem/skills/kwark-measure-outcome/SKILL.md) | Measure task completion and safety while keeping writing measures private. |
| [kwark-check-release](https://kwark.space/designSystem/skills/kwark-check-release/SKILL.md) | 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.

```bash
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

```bash
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.

```bash
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](https://kwark.space/designSystem/agents/mcp.md) installed: they tell the agent to use `get_component`, `get_tokens` and `audit_code` when they are available.

> **For agents:** 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
