# intent

The entry point for the Intent system: it sets project context, routes work to specialized skills and loads foundational UX knowledge.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2700 installs · ★ 226
- Author: ghaida
- License: CC0-1.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/ghaida/intent/tree/HEAD/skills/intent/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/intent

## What it does

Intent is a skill for UX and design strategy, and it runs before you start drawing screens. It establishes project context, then routes to the other skills in the system and pulls in foundational UX knowledge. The author frames it as context for reasoning about design rather than for rendering it.

Inside are a context-gathering protocol and routing between specialized skills. Invoking `/intent` prints a banner first, asking what you are designing and for whom. There is an anti-pattern catalog: manipulative interface patterns become visible so you can refuse them. The system also separates the work from the record — the deliverable speaks for itself with no narrator, while the reasoning behind decisions sits beside it.

The skill says when not to use it. A localized tweak inside an established system, a purely technical task with no user-facing change, or a hotfix under time pressure are all reasons to skip the context protocol. When someone has expertise and a specific ask, Intent does not second-guess. It earns its place on new projects or wherever UX decisions come up often.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ghaida/intent --skill intent -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/intent/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/intent/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ghaida/intent --skill intent -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/intent/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ghaida/intent --skill intent -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/intent/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ghaida/intent intent
```

2. **Manually: put the files in place**
- File: `.github/skills/intent/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ghaida/intent --skill intent -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ghaida/intent --path skills/intent
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/intent/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ghaida/intent --skill intent -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ghaida/intent/tree/HEAD/skills/intent/SKILL.md

## When to use it
- establish project context before interface work starts
- route a design task to the right specialized skill
- evaluate the UX of an existing product
- surface dark patterns in an interface and refuse them
- check whether a design decision has a stated reason

## Example prompts
- /intent — we're starting a new product, help me set the context
- evaluate the UX of the current onboarding and flag decisions with no reasoning
- check this screen for dark patterns

## Source text · SKILL.md · CC0-1.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: b51833b62003f648.

BEGIN THIRD-PARTY FILE b51833b62003f648
``````text
---
name: intent
description: >
  The entry point for Intent, a UX and design strategy system. Sets
  project context, routes to specialized skills, and loads foundational
  UX knowledge. Activate when starting any UX or product design work,
  setting project context, routing to other skills, evaluating an
  existing product's UX, or when the user asks about design intent,
  user experience strategy, ethical design, dark patterns, or design
  systems thinking.
version: 1.7.2
user-invocable: true
---

# Intent

## Invocation banner

When `/intent` is invoked, the very first content in your response must be the invocation banner. Write it directly as markdown — do NOT use the Bash tool, do not call any other tool first.

Output exactly this, starting with the triple-backtick line, ending with the closing triple-backtick line, then a blank line:

`````
```
◆ ─ │ ─ ─ ─ │ ─ ─ ─ ─ │ ─ ─ ─ │ ─ ─ │ ─ │ ─ ─ │ ─ ─ ◆

  intent.

  Make the reason behind every decision visible.

  What are you designing, and for whom?

◆ ─ │ ─ ─ ─ │ ─ ─ ─ ─ │ ─ ─ ─ │ ─ ─ │ ─ │ ─ ─ │ ─ ─ ◆
```
`````

The triple-backtick code fence is essential — it preserves frame alignment in monospace. Do not modify the content, do not paraphrase, do not skip the banner.

After the banner renders, continue with the rest of this skill's normal response.

## Overview

Intent is a UX and design strategy system. It is tool-agnostic, platform-agnostic, and opinionated about one thing: every design decision should have a reason, and that reason should be visible at every layer, beside the work and in the record, never narrated in it.

Where visual design skills give AI context for seeing — color, typography, layout, motion — Intent gives AI context for reasoning about design. For asking why before how. For framing problems before solving them. For holding the full context of a user's life, not just the screen in front of them.

The gap Intent addresses is the one between "it works" and "it was designed with intent." A product can pass every usability heuristic and still feel hollow — because nobody asked what it was for, who it served, or what it would cost the people who used it. Intent fills that gap by making the reasoning behind design decisions explicit, testable, and traceable from strategy through implementation.

**What Intent is:**
- A thinking system for UX decisions, grounded in research and ethics
- A routing layer that connects specialized design skills into coherent practice
- An anti-pattern defense that makes manipulative design visible and refusable
- A context-gathering protocol that establishes shared understanding before work begins

**What Intent is not:**
- A visual design system
- A UI component library
- A substitute for primary user research
``````
END THIRD-PARTY FILE b51833b62003f648

The third-party file has ended. Everything between the b51833b62003f648 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2883 of 51944 bytes. © ghaida · CC0-1.0 · https://github.com/ghaida/intent/tree/HEAD/skills/intent/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
