JohnWayneeee/ai-agent-skills / skills/figma-pencil-fsd-tailwind4
figma-pencil-fsd-tailwind4
VerifiedConvert Figma or Pencil designs into production-ready frontend code using Feature-Sliced Design and Tailwind CSS v4. Use when translating designs into code, extracting tokens, mapping UI to FSD layers (shared / entities / features / widgets / pages / app-shell / app), enforcing Server vs Client boundaries when applicable, or validating design-to-code fidelity.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.1 KB |
| references/accessibility-checklist.md | markdown | 2.8 KB |
| references/example-mapping.md | markdown | 4.2 KB |
| references/figma-mcp-workflow.md | markdown | 3.4 KB |
| references/fsd-mapping.md | markdown | 4.5 KB |
| references/pencil-workflow.md | markdown | 2.8 KB |
| references/project-contracts.md | markdown | 3.4 KB |
| references/rsc-boundaries.md | markdown | 2.9 KB |
| references/tailwind-tokens.md | markdown | 3.8 KB |
references/tailwind-tokens.md
View on GitHub# Tailwind 4 Tokens
This reference is specific to Tailwind CSS v4. If the project still uses v3, fall back to the project's existing config and skip the v4-only sections.
## What changed in v4
- Configuration is CSS-first. A JS config file is optional and usually empty.
- Tokens are declared in CSS via `@theme { ... }` and become utilities automatically.
- Entry point is a single `@import "tailwindcss";`, not three v3 directives.
- Dark mode is opt-in via `@custom-variant dark (...);`.
- Colors default to OKLCH so cross-channel mixing stays perceptually correct.
- Container queries (`@container`, `@max-*`, `@min-*`) are built in.
If the generated code still uses a JS config with `theme.extend`, three `@tailwind` directives, or `darkMode: 'class'` in JS, it is v3 style and must be rewritten.
## Where tokens live
- One global stylesheet owns all tokens. The exact path depends on the project's conventions (commonly a global stylesheet inside the entry or the design-system layer).
- Tokens are declared inside a single `@theme` block. Avoid splitting the same token group across files.
- Component files never declare tokens; they only consume utilities generated from `@theme`.
```css
@import "tailwindcss";
@custom-variant dark (&:where(.dark, .dark *));
@theme {
--color-background: oklch(1 0 0);
--color-foreground: oklch(0.18 0 0);
--color-surface: oklch(0.98 0 0);
--color-muted: oklch(0.6 0 0);
--color-border: oklch(0.92 0 0);
--color-primary: oklch(0.65 0.2 250);
--color-primary-foreground: oklch(1 0 0);
--color-destructive: oklch(0.62 0.22 25);
--radius-sm: 0.25rem;
--radius-md: 0.5rem;
--radius-lg: 0.75rem;
--font-sans: "Inter", ui-sans-serif, system-ui, sans-serif;
}
```
Anything declared in `@theme` is exposed both as a CSS variable (`var(--color-primary)`) and as a Tailwind utility (`bg-primary`, `text-primary`, `rounded-md`).
## Preferred semantic groups
Use semantic names, not raw color names. The exact list depends on the design system; a common baseline:
- `background`, `foreground`
- `surface`, `surface-foreground`
- `muted`, `muted-foreground`
- `border`, `ring`
- `primary`, `primary-foreground`
- `secondary`, `secondary-foreground`
- `accent`, `accent-foreground`
- `destructive`, `destructive-foreground`
- `success`, `warning`, `info`
Pair every fill token with its `*-foreground` counterpart so contrast is always available without recomputation.
## Rules
- Prefer semantic tokens over raw hex/oklch values in components.
- Each meaning resolves to exactly one token. No `primary-2`, `surface-alt`, `muted-soft` drift.
- Do not add a new token unless the design system explicitly defines it. If a value is one-off, use an arbitrary utility (`bg-[oklch(0.7_0.1_140)]`) and leave a `TODO(design)` comment for the design team to decide whether to promote it.
- Light and dark themes share the same token names. Override values inside the project's chosen dark variant (commonly a `.dark` selector), never invent parallel tokens.
```css
.dark {
--color-background: oklch(0.18 0 0);
--color-foreground: oklch(0.98 0 0);
--color-surface: oklch(0.22 0 0);
}
```
## Inline styles
Inline `style={{ ... }}` is allowed only for values that are not knowable at author time: dynamic position, scroll progress, computed transforms, animated values driven by JS. Static dimensions, colors, spacing, and radii must always go through utilities or arbitrary values, never inline.
## Anti-patterns
- Keeping a v3 JS config with `theme.extend` in a v4 project.
- Declaring color literals inside components instead of consuming tokens.
- Creating a new token per screen instead of reusing the semantic system.
- Using `dark:bg-zinc-900` style overrides on every component instead of a single dark-variant theme override.
- Using inline `style` for static styling that a utility could express.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |