# import

Imports an existing codebase or website design system into Subframe. Recreates theme tokens, typography, icon assets, and reusable component libraries.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 266 installs · ★ 467 repo stars
- Author: SubframeApp
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SubframeApp/subframe/tree/HEAD/plugins/subframe/skills/import/SKILL.md
- Updated: 2026-11-07
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/subframeapp-import

## What it does

The skill performs a strict audit of the source assets before touching destination themes. It parses Tailwind CSS configs, global stylesheet files, font rules, and icon sprites to establish a full N of M inventory. When inspecting live websites, the agent uses environment browser tools to examine computed styles and actual rendered states.

Execution order matters during the migration. Missing fonts and theme tokens land first, followed by icon glyphs, and finally UI components built from primitives up to composites. Dark values are stored as explicit dark mode overrides via `edit_theme` rather than flattened into base colors.

Runtime application logic and network calls stay in the original repository. The skill ports solely the visual contract, expressing dynamic states as Subframe component variants.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add SubframeApp/subframe --skill import -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add SubframeApp/subframe --skill import -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add SubframeApp/subframe --skill import -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install SubframeApp/subframe plugins/subframe/skills/import
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add SubframeApp/subframe --skill import -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/SubframeApp/subframe --path plugins/subframe/skills/import
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add SubframeApp/subframe --skill import -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/SubframeApp/subframe/tree/HEAD/plugins/subframe/skills/import/SKILL.md

## When to use it
- extract theme tokens from Tailwind CSS configurations into Subframe
- upload missing web fonts and recolorable SVG icons
- map dark mode overrides without flattening the primary palette
- recreate nested UI components in proper dependency order

## Example prompts
- Import the design system from this repository into Subframe.
- Transfer our Tailwind CSS theme tokens and dark mode overrides to Subframe.
- Audit and port button primitives and icon assets from the frontend directory into Subframe.

## Similar
- [figma-designer](https://affpapa.org/en/nevibecode/skills/elayadesign-figma-designer.md) — skill · 2900 installs
- [component-family-consistency](https://affpapa.org/en/nevibecode/skills/component-family-consistency.md) — skill · 1000 installs
- [foundation-extractor](https://affpapa.org/en/nevibecode/skills/foundation-extractor.md) — skill · ★ 529 repo stars
- [animated-component-libraries](https://affpapa.org/en/nevibecode/skills/animated-component-libraries.md) — skill · 3200 installs
- [design-system](https://affpapa.org/en/nevibecode/skills/anthropics-design-system.md) — skill · 4700 installs
- [aceternity-ui](https://affpapa.org/en/nevibecode/skills/aceternity-ui.md) — skill · 1600 installs

## Other versions with the same name
- [import · jaguarjack](https://affpapa.org/en/nevibecode/skills/import.md) — 1 install
- [import · insilico-org](https://affpapa.org/en/nevibecode/skills/insilico-org-import.md) — ★ 93 repo stars

From the same set: [subframeapp/subframe](https://affpapa.org/en/nevibecode/by/subframeapp/subframe.md) — 3 cards

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