Skip to content
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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fast4gc--craft-ui/badge.svg)](/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
  1. {
  2. "name": "craft-ui",
  3. "owner": { "name": "Fast4gc" },
  4. "plugins": [
  5. {
  6. "name": "craft-ui",
  7. "source": "./",
  8. "description": "Reference-to-layout design skill: SaaS, CRM, landing pages, Figma effects, GSAP motion, logo splash."
  9. }
  10. ]
  11. }
README.md · README · 213 lines · 1 finding marked
  1. <div align="center">
  2. # craft-ui
  3. **Da referência do Pinterest ao layout pronto.**
  4. 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.
  5. ![license](https://img.shields.io/badge/license-MIT-blue)
  6. ![format](https://img.shields.io/badge/format-Agent%20Skill%20(SKILL.md)-6f42c1)
  7. ![agents](https://img.shields.io/badge/agents-Claude%20Code%20%C2%B7%20Codex%20%C2%B7%20Trae%20%C2%B7%20Cursor%20%C2%B7%20Gemini%20%C2%B7%20%2B5-111)
  8. </div>
  9. ---
  10. ## O que ela faz
  11. 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.
  12. 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").
  13. | Categoria | Entrega |
  14. |---|---|
  15. | `saas-app` | Telas de aplicativo SaaS com shell, navegação e estados reais |
  16. | `crm-dashboard` | Dashboards de CRM/admin legíveis "num relance": pipeline, tabelas, status |
  17. | `landing-page` | Landing pages com hero, seções e CTA seguindo a estrutura da referência |
  18. | `figma-effects` | Glass, blur, sombras em camadas, gradiente, grain e glow em CSS/SVG |
  19. | `gsap-motion` | Entradas, scroll reveal, pin, marquee, botão magnético, contadores |
  20. | `logo-splash` | Tela de abertura com a sua marca, curta, pulável e com handoff limpo |
  21. ### Fluxo
  22. ```
  23. pedido do usuário + URL do site + referências
  24. │
  25. ├─► Agente A: site em produção ─► SITE CONTEXT BRIEF
  26. ├─► Agente B: pedido + referências ─► REQUEST BRIEF + STYLE DNA
  27. └─► Agente C: router de skills/economia ─► ROUTING DECISION
  28. │
  29. ▼
  30. DESIGN CONTRACT (gate: sem código antes dele)
  31. ▼
  32. plano (tokens + wireframe) ─► código ─► screenshot e comparação ─► ajustes
  33. ```
  34. 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`.
  35. 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.
  36. 3. **Plano:** tokens (cor, tipo, raio, sombra, easing) e wireframe antes de qualquer componente.
  37. 4. **Build:** HTML autocontido por padrão, responsivo (1440 / 768 / 390), com `prefers-reduced-motion` respeitado e o checklist anti-IA aplicado.
  38. 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.
  39. ### Os três agentes
  40. | Agente | O que ele responde | Entrega |
  41. |---|---|---|
  42. | **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) |
  43. | **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) |
  44. | **C — Router e economia** | Quais skills usar (e quais pular com motivo) e se a resposta será curta ou completa | `ROUTING DECISION` (≤ 200 palavras) |
  45. 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.
  46. ### Economia de tokens
  47. A economia é uma decisão do agente C, não um atalho que pula contexto:
  48. - `terse` (padrão quando o usuário quer só o artefato): resposta final de 3–5 linhas e 1 rodada de verificação.
  49. - `full`: explicação completa, traits da referência citados e até 3 rodadas de verificação.
  50. - 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.
  51. ### Anti-cópia de padrão
  52. `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.
  53. ### Anti "feito por IA"
  54. `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.
  55. ### Polir um site que já existe
  56. 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.
  57. ### Padrão profissional
  58. `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.
  59. ## Instalação
  60. ### Opção 1: `npx skills` (mais simples, vários agentes)
  61. ```bash
  62. npx skills add Fast4gc/craft-ui
  63. # só alguns agentes, no escopo do usuário:
  64. npx skills add Fast4gc/craft-ui -g -a claude-code -a codex
  65. ```
  66. ### Opção 2: instalador do repositório
  67. **macOS / Linux**
  68. ```bash
  69. git clone https://github.com/Fast4gc/craft-ui.git && cd craft-ui
  70. ./install.sh # todos os agentes detectados
  71. ./install.sh -a claude,codex,trae # agentes específicos
  72. ./install.sh -p -a trae # só no projeto atual
  73. ./install.sh --link # symlink: atualiza com git pull
  74. ```
  75. Sem clonar:
  76. ```bash
  77. 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
  78. ```
  79. **Windows (PowerShell)**
  80. ```powershell
  81. git clone https://github.com/Fast4gc/craft-ui.git; cd craft-ui
  82. .\install.ps1 # agentes detectados
  83. .\install.ps1 -Agent claude,codex,trae
  84. .\install.ps1 -Project -Agent trae
  85. ```
  86. ### Opção 3: plugin do Claude Code
  87. ```
  88. /plugin marketplace add Fast4gc/craft-ui
  89. /plugin install craft-ui@craft-ui
  90. ```
  91. ### Opção 4: manual ou importar arquivo
  92. 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.
  93. ### Agentes suportados
  94. | Agente | Pasta do usuário | Pasta do projeto |
  95. |---|---|---|
  96. | Claude Code | `~/.claude/skills/` | `.claude/skills/` |
  97. | Codex | `~/.codex/skills/` | `.agents/skills/` |
  98. | Trae | `~/.trae/skills/` | `.trae/skills/` |
  99. | Cursor | `~/.cursor/skills/` | `.cursor/skills/` |
  100. | Gemini CLI | `~/.gemini/skills/` | `.gemini/skills/` |
  101. | Antigravity | `~/.gemini/antigravity/skills/` | `.agent/skills/` |
  102. | OpenCode | `~/.config/opencode/skills/` | `.opencode/skills/` |
  103. | Kiro | `~/.kiro/skills/` | `.kiro/skills/` |
  104. | GitHub Copilot | `~/.copilot/skills/` | `.github/skills/` |
  105. | Cline | `~/.cline/skills/` | `.cline/skills/` |
  106. | Universal | `~/.agents/skills/` | `.agents/skills/` |
  107. > 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.
  108. ## Como usar
  109. Anexe a imagem de referência e peça em linguagem natural:
  110. ```
  111. Faz um dashboard de CRM nesse estilo [imagem]
  112. Landing page para um app de notas: estrutura da ref 1, cores da ref 3
  113. Splash do logo no estilo dessa ref, entrando no hero com GSAP
  114. Aplica esse efeito de vidro nos cards do meu painel
  115. Olha o site em produção em https://minhaempresa.com.br e conserta essa landing [print]
  116. ```
  117. Também dá para invocar direto: `/craft-ui` (Claude Code) ou "use a skill craft-ui" (Codex e outros).
  118. ## Skills que se combinam com ela
  119. 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.
  120. | Fase | Skill | Instalar |
  121. |---|---|---|
  122. | Direção e polimento | [Impeccable](https://github.com/pbakaus/impeccable) | `npx skills add pbakaus/impeccable --skill impeccable -g -y` |
  123. | Motion e microinterações | [emil-design-eng](https://github.com/emilkowalski/skills) | `npx skills add emilkowalski/skills --skill emil-design-eng` |
  124. | Rebuild 3D a partir de imagem | [img2threejs](https://github.com/hoainho/img2threejs) | `npx --yes img2threejs@latest install` |
  125. | Código enxuto | [ponytail](https://github.com/DietrichGebert/ponytail) | `claude plugin marketplace add DietrichGebert/ponytail` |
  126. | Verificação visual | Qualquer MCP de browser (ex.: Chrome DevTools MCP) | conforme a documentação do MCP |
  127. ## Atualizar e remover
  128. ```bash
  129. git pull && ./install.sh # atualizar (ou use --link uma vez)
  130. ./install.sh --uninstall -a all # remover
  131. npx skills update # se instalou via npx skills
  132. ```
  133. ## Estrutura
  134. ```
  135. craft-ui/
  136. ├── skills/craft-ui/
  137. │ ├── SKILL.md # fluxo, gate do Design Contract e orquestração
  138. │ ├── references/
  139. │ │ ├── agents.md # 3 agentes: schemas, orçamento, prompts
  140. │ │ ├── design-contract.md # template de fusão + gate antes do código
  141. │ │ ├── anti-ai-slop.md # sintomas e correções do layout genérico
  142. │ │ ├── quality-bar.md # definition of done profissional + verificação
  143. │ │ ├── polish-existing-site.md # fluxo aditivo para melhorar layout já publicado
  144. │ │ ├── pattern-transfer.md # impede copiar o hero da referência sem contexto
  145. │ │ ├── categories.md # baseline por categoria + slots de Style DNA
  146. │ │ ├── style-dna.md # como ler uma referência (exige evidência)
  147. │ │ └── motion-and-effects.md # efeitos Figma em CSS, GSAP e splash
  148. │ └── assets/refs.json # links das referências
  149. ├── install.sh · install.ps1 # instaladores
  150. ├── scripts/package.sh # gera dist/craft-ui.skill
  151. └── .claude-plugin/ # manifest do plugin do Claude Code
  152. ```
  153. ## Contribuindo com referências
  154. 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.
  155. ## Aviso sobre referências
  156. 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.
  157. ## Licença
  158. [MIT](LICENSE)
install.sh · Bundled script · 113 lines · 1 finding marked
  1. #!/usr/bin/env bash
  2. # craft-ui installer: copies (or symlinks) the skill into the skills folder of each coding agent.
  3. # Usage: ./install.sh [options]
  4. set -euo pipefail
  5. SKILL="craft-ui"
  6. REPO_URL="https://github.com/Fast4gc/craft-ui.git"
  7. # name | global skills dir | project skills dir | detect dir (exists when the agent is installed)
  8. AGENTS=(
  9. "claude|$HOME/.claude/skills|.claude/skills|$HOME/.claude"
  10. "codex|$HOME/.codex/skills|.agents/skills|$HOME/.codex"
  11. "trae|$HOME/.trae/skills|.trae/skills|$HOME/.trae"
  12. "cursor|$HOME/.cursor/skills|.cursor/skills|$HOME/.cursor"
  13. "gemini|$HOME/.gemini/skills|.gemini/skills|$HOME/.gemini"
  14. "antigravity|$HOME/.gemini/antigravity/skills|.agent/skills|$HOME/.gemini/antigravity"
  15. "opencode|$HOME/.config/opencode/skills|.opencode/skills|$HOME/.config/opencode"
  16. "kiro|$HOME/.kiro/skills|.kiro/skills|$HOME/.kiro"
  17. "copilot|$HOME/.copilot/skills|.github/skills|$HOME/.copilot"
  18. "cline|$HOME/.cline/skills|.cline/skills|$HOME/.cline"
  19. "universal|$HOME/.agents/skills|.agents/skills|$HOME/.agents"
  20. )
  21. usage() {
  22. cat << USAGE
  23. craft-ui installer
  24. Usage: ./install.sh [options]
  25. -a, --agent LIST Comma-separated agents, or "all". Default: every agent detected on this machine.
  26. Agents: $(for a in "${AGENTS[@]}"; do printf '%s ' "${a%%|*}"; done)
  27. -p, --project Install into the current project (./.claude/skills, ./.trae/skills, ...) instead of your user folder
  28. --path DIR Install into a custom skills directory (ignores --agent)
  29. --link Symlink to this checkout instead of copying (updates with git pull)
  30. -u, --uninstall Remove the skill instead of installing it
  31. -l, --list Show agents and their install paths
  32. -h, --help Show this help
  33. Examples:
  34. ./install.sh # detected agents, user scope
  35. ./install.sh -a claude,codex,trae # specific agents
  36. ./install.sh -p -a trae # this project only, for Trae
  37. 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
  38. USAGE
  39. }
  40. want="" scope="global" custom="" link=0 uninstall=0 list=0
  41. while [ $# -gt 0 ]; do
  42. case "$1" in
  43. -a|--agent) want="${2:-}"; shift 2 ;;
  44. -p|--project) scope="project"; shift ;;
  45. --path) custom="${2:-}"; shift 2 ;;
  46. --link) link=1; shift ;;
  47. -u|--uninstall) uninstall=1; shift ;;
  48. -l|--list) list=1; shift ;;
  49. -h|--help) usage; exit 0 ;;
  50. *) echo "Unknown option: $1" >&2; usage; exit 1 ;;
  51. esac
  52. done
  53. if [ "$list" = 1 ]; then
  54. printf '%-12s %-45s %s\n' AGENT "USER PATH" "PROJECT PATH"
  55. for a in "${AGENTS[@]}"; do IFS='|' read -r n g p d <<< "$a"; printf '%-12s %-45s %s\n' "$n" "${g/#$HOME/~}" "$p"; done
  56. exit 0
  57. fi
  58. # Locate the skill sources: next to this script, or clone to a temp dir (curl | bash case).
  59. here="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" 2>/dev/null && pwd || echo "")"
  60. src="$here/skills/$SKILL"
  61. tmp=""
  62. if [ ! -f "$src/SKILL.md" ] && [ "$uninstall" = 0 ]; then
  63. command -v git >/dev/null || { echo "git is required to download craft-ui." >&2; exit 1; }
  64. tmp="$(mktemp -d)"; trap '[ -n "$tmp" ] && rm -rf "$tmp"' EXIT
  65. git clone --depth 1 "$REPO_URL" "$tmp/repo" >/dev/null 2>&1
  66. src="$tmp/repo/skills/$SKILL"
  67. [ "$link" = 1 ] && { echo "--link needs a local checkout; copying instead."; link=0; }
  68. fi
  69. targets=()
  70. if [ -n "$custom" ]; then
  71. targets+=("custom|$custom")
  72. else
  73. for a in "${AGENTS[@]}"; do
  74. IFS='|' read -r n g p d <<< "$a"
  75. if [ "$scope" = "project" ]; then dir="$PWD/$p"; else dir="$g"; fi
  76. if [ -z "$want" ]; then
  77. # auto mode: only detected agents, and skip "universal" unless asked
  78. [ "$n" = "universal" ] && continue
  79. [ -d "$d" ] && targets+=("$n|$dir")
  80. elif [ "$want" = "all" ] || [[ ",$want," == *",$n,"* ]]; then
  81. targets+=("$n|$dir")
  82. fi
  83. done
  84. fi
  85. if [ ${#targets[@]} -eq 0 ]; then
  86. echo "No supported agent detected. Pick one with --agent (see --list) or use --path DIR." >&2
  87. exit 1
  88. fi
  89. for t in "${targets[@]}"; do
  90. n="${t%%|*}"; dir="${t#*|}"; dest="$dir/$SKILL"
  91. if [ "$uninstall" = 1 ]; then
  92. if [ -e "$dest" ] || [ -L "$dest" ]; then rm -rf "$dest"; echo "removed $n ${dest/#$HOME/~}"; else echo "not found $n ${dest/#$HOME/~}"; fi
  93. continue
  94. fi
  95. mkdir -p "$dir"
  96. rm -rf "$dest"
  97. if [ "$link" = 1 ]; then ln -s "$src" "$dest"; mode="linked "; else cp -R "$src" "$dest"; mode="installed"; fi
  98. echo "$mode $n ${dest/#$HOME/~}"
  99. done
  100. [ "$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 in

Free to use. If it’s helped, pass it on.