Back to search
craft-ui
MarketplaceWorks with Claude CodeGitHub
Agent skill that turns Pinterest/Dribbble references into built layouts: SaaS apps, CRM dashboards, landing pages, Figma-style effects, GSAP motion and logo splash. Works with Claude Code, Codex, Trae, Cursor, Gemini CLI and more.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/fast4gc--craft-ui)HTML
<a href="/listings/fast4gc--craft-ui"><img src="/api/listings/fast4gc--craft-ui/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 11 lines
- {
- "name": "craft-ui",
- "owner": { "name": "Fast4gc" },
- "plugins": [
- {
- "name": "craft-ui",
- "source": "./",
- "description": "Reference-to-layout design skill: SaaS, CRM, landing pages, Figma effects, GSAP motion, logo splash."
- }
- ]
- }
README.md · README · 213 lines · 1 finding marked
- <div align="center">
- # craft-ui
- **Da referência do Pinterest ao layout pronto.**
- Uma skill para agentes de código que lê o estilo de uma imagem e reconstrói em código real: SaaS, CRM, landing pages, efeitos Figma, GSAP e splash de logo.
- 
- -6f42c1)
- 
- </div>
- ---
- ## O que ela faz
- Você manda uma referência (print, pin, imagem) e pede "faz nesse estilo" — ou só aponta o site em produção e pede para consertar a landing. A skill não copia pixels: extrai o **sistema de estilo** da imagem (paleta, tipografia, raios, sombras, densidade, grid, motion) e reconstrói com o **seu** conteúdo.
- Antes de escrever qualquer linha de código, ela roda **três agentes de descoberta**: um entende o site em produção, outro decodifica o pedido e busca/analisa referências, e o terceiro decide quais skills extras usar e o quanto falar. O resultado é um **Design Contract** — estrutura, conteúdo real e tokens com origem — que trava o layout e impede o resultado genérico ("feito por IA").
- | Categoria | Entrega |
- |---|---|
- | `saas-app` | Telas de aplicativo SaaS com shell, navegação e estados reais |
- | `crm-dashboard` | Dashboards de CRM/admin legíveis "num relance": pipeline, tabelas, status |
- | `landing-page` | Landing pages com hero, seções e CTA seguindo a estrutura da referência |
- | `figma-effects` | Glass, blur, sombras em camadas, gradiente, grain e glow em CSS/SVG |
- | `gsap-motion` | Entradas, scroll reveal, pin, marquee, botão magnético, contadores |
- | `logo-splash` | Tela de abertura com a sua marca, curta, pulável e com handoff limpo |
- ### Fluxo
- ```
- pedido do usuário + URL do site + referências
- │
- ├─► Agente A: site em produção ─► SITE CONTEXT BRIEF
- ├─► Agente B: pedido + referências ─► REQUEST BRIEF + STYLE DNA
- └─► Agente C: router de skills/economia ─► ROUTING DECISION
- │
- ▼
- DESIGN CONTRACT (gate: sem código antes dele)
- ▼
- plano (tokens + wireframe) ─► código ─► screenshot e comparação ─► ajustes
- ```
- 1. **Descoberta (3 agentes, em paralelo quando possível):** A lê o site em produção e o repo; B entende o pedido, busca referências quando não vieram nenhuma e escreve o Style DNA só do que realmente viu; C escolhe o mínimo de skills extras e define `terse` ou `full`.
- 2. **Design Contract:** fusão dos três briefs. Cada seção tem um trabalho, uma origem e conteúdo real; cada token cita sua fonte. Se faltar informação, a skill pergunta — nunca inventa.
- 3. **Plano:** tokens (cor, tipo, raio, sombra, easing) e wireframe antes de qualquer componente.
- 4. **Build:** HTML autocontido por padrão, responsivo (1440 / 768 / 390), com `prefers-reduced-motion` respeitado e o checklist anti-IA aplicado.
- 5. **Verificação:** compara com a referência e com o site lado a lado, exige conteúdo em toda a altura da página e corrige as maiores diferenças primeiro.
- ### Os três agentes
- | Agente | O que ele responde | Entrega |
- |---|---|---|
- | **A — Produção** | Quem é o produto, para quem, o que diz hoje, qual é a ação principal e quais tokens já existem | `SITE CONTEXT BRIEF` (≤ 300 palavras) |
- | **B — Pedido e referência** | O que o usuário realmente quer, o que está fora de escopo, e como é a referência vista | `REQUEST BRIEF + STYLE DNA` (≤ 350 palavras + 100 por referência) |
- | **C — Router e economia** | Quais skills usar (e quais pular com motivo) e se a resposta será curta ou completa | `ROUTING DECISION` (≤ 200 palavras) |
- Especificações, schemas e orçamento de palavras: `skills/craft-ui/references/agents.md`. Sem ferramenta de subagent, os três passos rodam sequencialmente no próprio agente, com os mesmos cabeçalhos.
- ### Economia de tokens
- A economia é uma decisão do agente C, não um atalho que pula contexto:
- - `terse` (padrão quando o usuário quer só o artefato): resposta final de 3–5 linhas e 1 rodada de verificação.
- - `full`: explicação completa, traits da referência citados e até 3 rodadas de verificação.
- - Só os arquivos de referência necessários são lidos; `discovery: lite` vale apenas para ajustes minúsculos em código existente, nunca para uma página nova — e mesmo assim o Design Contract encurta, nunca desaparece.
- ### Anti-cópia de padrão
- `skills/craft-ui/references/pattern-transfer.md` ataca o erro mais caro: a skill ver um hero com glow lateral + grade de pontos + dock flutuante e replicar isso em qualquer produto. Agora **tokens de estilo são portáveis; composição não**. Cada padrão admitido entra no Design Contract com evidência do produto (agente A) **e** do pedido (agente B) — se o layout serviria para uma padaria ou um escritório de advocacia, ele é rejeitado.
- ### Anti "feito por IA"
- `skills/craft-ui/references/anti-ai-slop.md` ataca os sintomas que geram o layout errado: faixa vazia no meio da página, pilha aleatória de seções, texto placeholder, gradientes padrão, cards todos iguais, fade-up em tudo, idioma errado e páginas longas sem conteúdo. Regra rápida: para cada seção, diga **qual pergunta ela responde, de onde veio e que conteúdo real contém** — se não der, ela é cortada antes do código.
- ### Polir um site que já existe
- Quando o pedido é "essa landing está amadora", a skill não reconstrói: ela segue `skills/craft-ui/references/polish-existing-site.md`. O fluxo é **aditivo** (respeita alterações não commitadas), começa com screenshots antes/depois em 1440/768/390 e ataca sinais concretos: micro-tipografia, ritmo de seções apertado, hierarquia fraca e estados de carregamento/vazio/erro crus. A verificação usa os comandos do próprio projeto (build + testes) antes de declarar entrega.
- ### Padrão profissional
- `skills/craft-ui/references/quality-bar.md` é o definition of done: conteúdo real, fidelidade visual, responsividade em 1440/768/390, base WCAG AA (contraste, foco, semântica, reduced motion), performance/robustez e handoff limpo. O protocolo de verificação usa screenshots de página inteira — é assim que uma faixa vazia aparece. Vale para modo `terse` e `full`; a economia muda o quanto se fala, nunca o que é aceitável entregar.
- ## Instalação
- ### Opção 1: `npx skills` (mais simples, vários agentes)
- ```bash
- npx skills add Fast4gc/craft-ui
- # só alguns agentes, no escopo do usuário:
- npx skills add Fast4gc/craft-ui -g -a claude-code -a codex
- ```
- ### Opção 2: instalador do repositório
- **macOS / Linux**
- ```bash
- git clone https://github.com/Fast4gc/craft-ui.git && cd craft-ui
- ./install.sh # todos os agentes detectados
- ./install.sh -a claude,codex,trae # agentes específicos
- ./install.sh -p -a trae # só no projeto atual
- ./install.sh --link # symlink: atualiza com git pull
- ```
- Sem clonar:
- ```bash
- curl -fsSL https://raw.githubusercontent.com/Fast4gc/craft-ui/main/install.sh | bash -s -- -a claude
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 109 on GitHub
- ```
- **Windows (PowerShell)**
- ```powershell
- git clone https://github.com/Fast4gc/craft-ui.git; cd craft-ui
- .\install.ps1 # agentes detectados
- .\install.ps1 -Agent claude,codex,trae
- .\install.ps1 -Project -Agent trae
- ```
- ### Opção 3: plugin do Claude Code
- ```
- /plugin marketplace add Fast4gc/craft-ui
- /plugin install craft-ui@craft-ui
- ```
- ### Opção 4: manual ou importar arquivo
- Copie `skills/craft-ui/` para a pasta de skills do seu agente (tabela abaixo). No **Trae**, também dá para importar `craft-ui.skill` (gerado com `./scripts/package.sh` ou baixado em Releases), que é um zip com `SKILL.md` na raiz.
- ### Agentes suportados
- | Agente | Pasta do usuário | Pasta do projeto |
- |---|---|---|
- | Claude Code | `~/.claude/skills/` | `.claude/skills/` |
- | Codex | `~/.codex/skills/` | `.agents/skills/` |
- | Trae | `~/.trae/skills/` | `.trae/skills/` |
- | Cursor | `~/.cursor/skills/` | `.cursor/skills/` |
- | Gemini CLI | `~/.gemini/skills/` | `.gemini/skills/` |
- | Antigravity | `~/.gemini/antigravity/skills/` | `.agent/skills/` |
- | OpenCode | `~/.config/opencode/skills/` | `.opencode/skills/` |
- | Kiro | `~/.kiro/skills/` | `.kiro/skills/` |
- | GitHub Copilot | `~/.copilot/skills/` | `.github/skills/` |
- | Cline | `~/.cline/skills/` | `.cline/skills/` |
- | Universal | `~/.agents/skills/` | `.agents/skills/` |
- > Os agentes mudam esses caminhos com frequência. Se o seu não carregar a skill, confira a documentação dele e use `./install.sh --path <pasta>`. Depois de instalar, reinicie o agente ou abra uma nova sessão.
- ## Como usar
- Anexe a imagem de referência e peça em linguagem natural:
- ```
- Faz um dashboard de CRM nesse estilo [imagem]
- Landing page para um app de notas: estrutura da ref 1, cores da ref 3
- Splash do logo no estilo dessa ref, entrando no hero com GSAP
- Aplica esse efeito de vidro nos cards do meu painel
- Olha o site em produção em https://minhaempresa.com.br e conserta essa landing [print]
- ```
- Também dá para invocar direto: `/craft-ui` (Claude Code) ou "use a skill craft-ui" (Codex e outros).
- ## Skills que se combinam com ela
- O agente C decide **por execução** quais destas skills usar e quais pular (com motivo). A `craft-ui` tem fallback embutido quando não estão instaladas.
- | Fase | Skill | Instalar |
- |---|---|---|
- | Direção e polimento | [Impeccable](https://github.com/pbakaus/impeccable) | `npx skills add pbakaus/impeccable --skill impeccable -g -y` |
- | Motion e microinterações | [emil-design-eng](https://github.com/emilkowalski/skills) | `npx skills add emilkowalski/skills --skill emil-design-eng` |
- | Rebuild 3D a partir de imagem | [img2threejs](https://github.com/hoainho/img2threejs) | `npx --yes img2threejs@latest install` |
- | Código enxuto | [ponytail](https://github.com/DietrichGebert/ponytail) | `claude plugin marketplace add DietrichGebert/ponytail` |
- | Verificação visual | Qualquer MCP de browser (ex.: Chrome DevTools MCP) | conforme a documentação do MCP |
- ## Atualizar e remover
- ```bash
- git pull && ./install.sh # atualizar (ou use --link uma vez)
- ./install.sh --uninstall -a all # remover
- npx skills update # se instalou via npx skills
- ```
- ## Estrutura
- ```
- craft-ui/
- ├── skills/craft-ui/
- │ ├── SKILL.md # fluxo, gate do Design Contract e orquestração
- │ ├── references/
- │ │ ├── agents.md # 3 agentes: schemas, orçamento, prompts
- │ │ ├── design-contract.md # template de fusão + gate antes do código
- │ │ ├── anti-ai-slop.md # sintomas e correções do layout genérico
- │ │ ├── quality-bar.md # definition of done profissional + verificação
- │ │ ├── polish-existing-site.md # fluxo aditivo para melhorar layout já publicado
- │ │ ├── pattern-transfer.md # impede copiar o hero da referência sem contexto
- │ │ ├── categories.md # baseline por categoria + slots de Style DNA
- │ │ ├── style-dna.md # como ler uma referência (exige evidência)
- │ │ └── motion-and-effects.md # efeitos Figma em CSS, GSAP e splash
- │ └── assets/refs.json # links das referências
- ├── install.sh · install.ps1 # instaladores
- ├── scripts/package.sh # gera dist/craft-ui.skill
- └── .claude-plugin/ # manifest do plugin do Claude Code
- ```
- ## Contribuindo com referências
- As seções **Reference DNA** em `references/categories.md` começam vazias de propósito: só devem ser preenchidas a partir de imagens realmente analisadas. Abra um PR com o DNA preenchido seguindo o template de `references/style-dna.md`. Não inclua imagens ou assets de terceiros no repositório, apenas links e descrições do estilo.
- ## Aviso sobre referências
- Muitas referências do Pinterest apontam para UI kits comerciais. A skill foi escrita para recriar **padrões e estilo**, não logos, ilustrações, marcas ou textos de terceiros.
- ## Licença
- [MIT](LICENSE)
install.sh · Bundled script · 113 lines · 1 finding marked
- #!/usr/bin/env bash
- # craft-ui installer: copies (or symlinks) the skill into the skills folder of each coding agent.
- # Usage: ./install.sh [options]
- set -euo pipefail
- SKILL="craft-ui"
- REPO_URL="https://github.com/Fast4gc/craft-ui.git"
- # name | global skills dir | project skills dir | detect dir (exists when the agent is installed)
- AGENTS=(
- "claude|$HOME/.claude/skills|.claude/skills|$HOME/.claude"
- "codex|$HOME/.codex/skills|.agents/skills|$HOME/.codex"
- "trae|$HOME/.trae/skills|.trae/skills|$HOME/.trae"
- "cursor|$HOME/.cursor/skills|.cursor/skills|$HOME/.cursor"
- "gemini|$HOME/.gemini/skills|.gemini/skills|$HOME/.gemini"
- "antigravity|$HOME/.gemini/antigravity/skills|.agent/skills|$HOME/.gemini/antigravity"
- "opencode|$HOME/.config/opencode/skills|.opencode/skills|$HOME/.config/opencode"
- "kiro|$HOME/.kiro/skills|.kiro/skills|$HOME/.kiro"
- "copilot|$HOME/.copilot/skills|.github/skills|$HOME/.copilot"
- "cline|$HOME/.cline/skills|.cline/skills|$HOME/.cline"
- "universal|$HOME/.agents/skills|.agents/skills|$HOME/.agents"
- )
- usage() {
- cat << USAGE
- craft-ui installer
- Usage: ./install.sh [options]
- -a, --agent LIST Comma-separated agents, or "all". Default: every agent detected on this machine.
- Agents: $(for a in "${AGENTS[@]}"; do printf '%s ' "${a%%|*}"; done)
- -p, --project Install into the current project (./.claude/skills, ./.trae/skills, ...) instead of your user folder
- --path DIR Install into a custom skills directory (ignores --agent)
- --link Symlink to this checkout instead of copying (updates with git pull)
- -u, --uninstall Remove the skill instead of installing it
- -l, --list Show agents and their install paths
- -h, --help Show this help
- Examples:
- ./install.sh # detected agents, user scope
- ./install.sh -a claude,codex,trae # specific agents
- ./install.sh -p -a trae # this project only, for Trae
- curl -fsSL https://raw.githubusercontent.com/Fast4gc/craft-ui/main/install.sh | bash -s -- -a claude
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 43 on GitHub
- USAGE
- }
- want="" scope="global" custom="" link=0 uninstall=0 list=0
- while [ $# -gt 0 ]; do
- case "$1" in
- -a|--agent) want="${2:-}"; shift 2 ;;
- -p|--project) scope="project"; shift ;;
- --path) custom="${2:-}"; shift 2 ;;
- --link) link=1; shift ;;
- -u|--uninstall) uninstall=1; shift ;;
- -l|--list) list=1; shift ;;
- -h|--help) usage; exit 0 ;;
- *) echo "Unknown option: $1" >&2; usage; exit 1 ;;
- esac
- done
- if [ "$list" = 1 ]; then
- printf '%-12s %-45s %s\n' AGENT "USER PATH" "PROJECT PATH"
- for a in "${AGENTS[@]}"; do IFS='|' read -r n g p d <<< "$a"; printf '%-12s %-45s %s\n' "$n" "${g/#$HOME/~}" "$p"; done
- exit 0
- fi
- # Locate the skill sources: next to this script, or clone to a temp dir (curl | bash case).
- here="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" 2>/dev/null && pwd || echo "")"
- src="$here/skills/$SKILL"
- tmp=""
- if [ ! -f "$src/SKILL.md" ] && [ "$uninstall" = 0 ]; then
- command -v git >/dev/null || { echo "git is required to download craft-ui." >&2; exit 1; }
- tmp="$(mktemp -d)"; trap '[ -n "$tmp" ] && rm -rf "$tmp"' EXIT
- git clone --depth 1 "$REPO_URL" "$tmp/repo" >/dev/null 2>&1
- src="$tmp/repo/skills/$SKILL"
- [ "$link" = 1 ] && { echo "--link needs a local checkout; copying instead."; link=0; }
- fi
- targets=()
- if [ -n "$custom" ]; then
- targets+=("custom|$custom")
- else
- for a in "${AGENTS[@]}"; do
- IFS='|' read -r n g p d <<< "$a"
- if [ "$scope" = "project" ]; then dir="$PWD/$p"; else dir="$g"; fi
- if [ -z "$want" ]; then
- # auto mode: only detected agents, and skip "universal" unless asked
- [ "$n" = "universal" ] && continue
- [ -d "$d" ] && targets+=("$n|$dir")
- elif [ "$want" = "all" ] || [[ ",$want," == *",$n,"* ]]; then
- targets+=("$n|$dir")
- fi
- done
- fi
- if [ ${#targets[@]} -eq 0 ]; then
- echo "No supported agent detected. Pick one with --agent (see --list) or use --path DIR." >&2
- exit 1
- fi
- for t in "${targets[@]}"; do
- n="${t%%|*}"; dir="${t#*|}"; dest="$dir/$SKILL"
- if [ "$uninstall" = 1 ]; then
- if [ -e "$dest" ] || [ -L "$dest" ]; then rm -rf "$dest"; echo "removed $n ${dest/#$HOME/~}"; else echo "not found $n ${dest/#$HOME/~}"; fi
- continue
- fi
- mkdir -p "$dir"
- rm -rf "$dest"
- if [ "$link" = 1 ]; then ln -s "$src" "$dest"; mode="linked "; else cp -R "$src" "$dest"; mode="installed"; fi
- echo "$mode $n ${dest/#$HOME/~}"
- done
- [ "$uninstall" = 1 ] || echo "Done. Restart your agent (or start a new session), then ask for a layout \"in the style of\" a reference image."
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.