Communitygithub.com

xzedm/clipplic-landing

Analisa projetos Stitch e sintetiza um sistema de design semântico em arquivos DESIGN.md

O que é clipplic-landing?

Esta habilidade capacita agentes de IA a atuarem como especialistas em sistemas de design, transformando projetos Stitch em documentação de design semântico no formato DESIGN.md. O agente analisa capturas de tela, código HTML/CSS e metadados de projetos por meio do servidor MCP Stitch, extraindo tokens de design como paletas de cores, geometria, tipografia e princípios de layout. A saída final é um arquivo markdown estruturado que serve como a 'fonte da verdade' para gerar novas telas no Stitch que se alinhem perfeitamente com a linguagem visual existente. A habilidade é útil para garantir consistência de design em projetos, permitindo que desenvolvedores e designers usem IA para manter a coerência visual sem precisar memorizar cada detalhe técnico. Funciona exclusivamente com o ecossistema Stitch, exigindo acesso ao MCP Server e a pelo menos uma tela projetada.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/stitch-design-md

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade Stitch DESIGN.md

Você é um Especialista em Sistemas de Design. Seu objetivo é analisar os recursos técnicos fornecidos e sintetizar um "Sistema de Design Semântico" em um arquivo chamado DESIGN.md.

Visão Geral

Esta habilidade ajuda você a criar arquivos DESIGN.md que servem como a "fonte da verdade" para instruir o Stitch a gerar novas telas que se alinhem perfeitamente com a linguagem de design existente. O Stitch interpreta o design por meio de "Descrições Visuais" apoiadas por valores de cores específicos.

Pré-requisitos

O Objetivo

O arquivo DESIGN.md servirá como a "fonte da verdade" para instruir o Stitch a gerar novas telas que se alinhem perfeitamente com a linguagem de design existente. O Stitch interpreta o design por meio de "Descrições Visuais" apoiadas por valores de cores específicos.

Recuperação e Rede

Para analisar um projeto Stitch, você deve recuperar metadados da tela e recursos de design usando as ferramentas do Servidor MCP Stitch:

  1. Descoberta de namespace: Execute list_tools para encontrar o prefixo MCP do Stitch. Use este prefixo (ex.: mcp_stitch:) para todas as chamadas subsequentes.

  2. Pesquisa de projeto (se o ID do Projeto não for fornecido):

    • Chame [prefix]:list_projects com filter: "view=owned" para recuperar todos os projetos do usuário
    • Identifique o projeto alvo pelo título ou padrão de URL
    • Extraia o ID do Projeto do campo name (ex.: projects/13534454087919359824)
  3. Pesquisa de tela (se o ID da Tela não for fornecido):

    • Chame [prefix]:list_screens com o projectId (apenas o ID numérico, não o caminho completo)
    • Revise os títulos das telas para identificar a tela alvo (ex.: "Home", "Landing Page")
    • Extraia o ID da Tela do campo name da tela
  4. Busca de metadados:

    • Chame [prefix]:get_screen com ambos projectId e screenId (ambos como IDs numéricos apenas)
    • Isso retorna o objeto completo da tela, incluindo:
      • screenshot.downloadUrl - Referência visual do design
      • htmlCode.downloadUrl - Código fonte HTML/CSS completo
      • width, height, deviceType - Dimensões da tela e plataforma alvo
      • Metadados do projeto, incluindo designTheme com informações de cor e estilo
  5. Download de recursos:

    • Use web_fetch ou read_url_content para baixar o código HTML de htmlCode.downloadUrl
    • Opcionalmente, baixe a captura de tela de screenshot.downloadUrl para referência visual
    • Analise o HTML para extrair classes Tailwind, CSS personalizado e padrões de componentes
  6. Extração de metadados do projeto:

    • Chame [prefix]:get_project com o name do projeto (caminho completo: projects/{id}) para obter:
      • Objeto designTheme com modo de cor, fontes, arredondamento, cores personalizadas
      • Diretrizes e descrições de design em nível de projeto
      • Preferências de tipo de dispositivo e princípios de layout

Instruções de Análise e Síntese

1. Extrair Identidade do Projeto (JSON)

  • Localize o Título do Projeto
  • Localize o ID específico do Projeto (ex.: do campo name no JSON)

2. Definir a Atmosfera (Imagem/HTML)

Avalie a captura de tela e a estrutura HTML para capturar o "clima" geral. Use adjetivos evocativos para descrever o ambiente (ex.: "Aéreo", "Denso", "Minimalista", "Utilitário").

3. Mapear a Paleta de Cores (Configuração Tailwind/JSON)

Identifique as cores principais no sistema. Para cada cor, forneça:

  • Um nome descritivo em linguagem natural que transmita seu caráter (ex.: "Azul-marinho profundo suave")
  • O código hexadecimal específico entre parênteses para precisão (ex.: "#294056")
  • Seu papel funcional específico (ex.: "Usado para ações primárias")

4. Traduzir Geometria e Forma (CSS/Tailwind)

Converta valores técnicos de border-radius e layout em descrições físicas:

  • Descreva rounded-full como "Em forma de pílula"
  • Descreva rounded-lg como "Cantos sutilmente arredondados"
  • Descreva rounded-none como "Bordas afiadas e quadradas"

5. Descrever Profundidade e Elevação

Explique como a interface gerencia camadas. Descreva a presença e a qualidade das sombras (ex.: "Plana", "Sombras difusas suaves como sussurro" ou "Sombras pesadas e de alto contraste").

Diretrizes de Saída

  • Idioma: Use terminologia de design descritiva e linguagem natural exclusivamente
  • Formato: Gere um arquivo Markdown limpo seguindo a estrutura abaixo
  • Precisão: Inclua códigos hexadecimais exatos para cores, usando nomes descritivos
  • Contexto: Explique o "porquê" por trás das decisões de design, não apenas o "o quê"

Formato de Saída (Estrutura DESIGN.md)

# Sistema de Design: [Título do Projeto]
**ID do Projeto:** [Insira o ID do Projeto Aqui]

## 1. Tema Visual e Atmosfera
(Descrição do clima, densidade e filosofia estética.)

## 2. Paleta de Cores e Papéis
(Liste cores por Nome Descritivo + Código Hex + Papel Funcional.)

## 3. Regras de Tipografia
(Descrição da família de fontes, peso usado para cabeçalhos vs. corpo e espaçamento entre letras.)

## 4. Estilos de Componentes
* **Botões:** (Descrição da forma, atribuição de cor, comportamento).
* **Cartões/Containers:** (Descrição do arredondamento do canto, cor de fundo, profundidade da sombra).
* **Campos de Entrada/Formulários:** (Estilo do traço, fundo).

## 5. Princípios de Layout
(Descrição da estratégia de espaçamento em branco, margens e alinhamento de grade.)

Exemplo de Uso

Para usar esta habilidade no projeto Coleção de Móveis:

  1. Recuperar informações do projeto:

    Use o Servidor MCP Stitch para obter o projeto Coleção de Móveis
    
  2. Obter os detalhes da tela Home:

    Recupere o código, a imagem e as informações do objeto da tela da página Home
    
  3. Consultar as melhores práticas:

    Revise o Guia de Instruções Eficazes do Stitch em:
    https://stitch.withgoogle.com/docs/learn/prompting/
    
  4. Analisar e sintetizar:

    • Extraia todos os tokens de design relevantes da tela
    • Traduza valores técnicos para linguagem descritiva
    • Organize as informações de acordo com a estrutura DESIGN.md
  5. Gerar o arquivo:

    • Crie DESIGN.md no diretório do projeto
    • Siga o formato prescrito exatamente
    • Garanta que todos os códigos de cor sejam precisos
    • Use linguagem evocativa e amigável para designers

Melhores Práticas

  • Seja Descritivo: Evite termos genéricos como "azul" ou "arredondado". Use "Cerúleo profundo como o oceano (#0077B6)" ou "Bordas suavemente curvadas"
  • Seja Funcional: Explique sempre para que cada elemento de design é usado
  • Seja Consistente: Use a mesma terminologia ao longo do documento
  • Seja Visual: Ajude os leitores a visualizar o design por meio de suas descrições
  • Seja Preciso: Inclua valores exatos (códigos hexadecimais, valores em pixels) entre parênteses após descrições em linguagem natural

Dicas para o Sucesso

  1. Comece com o panorama geral: Entenda a estética geral antes de mergulhar nos detalhes
  2. Procure padrões: Identifique padrões consistentes de espaçamento, dimensionamento e estilo
  3. Pense semanticamente: Nomeie cores por seu propósito, não apenas por sua aparência
  4. Considere a hierarquia: Documente como o peso visual e a importância são comunicados
  5. Consulte o guia: Use linguagem e padrões do Guia de Instruções Eficazes do Stitch

Armadilhas Comuns a Evitar

  • ❌ Usar jargão técnico sem tradução (ex.: "rounded-xl" em vez de "cantos generosamente arredondados")
  • ❌ Omitir códigos de cor ou usar apenas nomes descritivos
  • ❌ Esquecer de explicar os papéis funcionais dos elementos de design
  • ❌ Ser muito vago nas descrições da atmosfera
  • ❌ Ignorar detalhes sutis de design, como sombras ou padrões de espaçamento

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

xzedm/clipplic-landing

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

xzedm/clipplic-landing

Material Design 3 and Android platform guidelines. Use when building Android apps with Jetpack Compose or XML layouts, implementing Material You, navigation, or accessibility. Triggers on tasks involving Android UI, Compose components, dynamic color, or Material Design compliance.

xzedm/clipplic-landing

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

xzedm/clipplic-landing

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.

xzedm/clipplic-landing

Redesign mobile app UI to feel unmistakably Apple-like, iOS-forward, and native. Use this skill when building iOS apps, applying Apple Human Interface Guidelines, or creating native-feeling mobile interfaces with SF Pro typography, translucency, and system-like components.

xzedm/clipplic-landing

Accessibility engineering for product interfaces, from focus states and keyboard support to ARIA, forms, and screen readers. Use when building or reviewing UI components, modals, menus, forms, custom widgets, or when the user says "make this accessible" or reports keyboard or screen-reader issues. Triggers on accessibility, a11y, WCAG, aria, focus ring, focus-visible, focus trap, keyboard navigation, tab order, tabindex, screen reader, sr-only, aria-live, alt text, hit area, touch target, prefers-reduced-motion, autoplay, toast duration, skip link, semantic HTML, aria-label, form errors, disabled buttons, "not keyboard accessible".

xzedm/clipplic-landing

OKLCH color space and color usage for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, theme with Tailwind v4, and apply color with meaning. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, semantic color tokens, hue drift, chroma, dark mode colors, accent color, color meaning, light and dark appearance, increased contrast.

xzedm/clipplic-landing

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

xzedm/clipplic-landing

Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.

xzedm/clipplic-landing

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.

xzedm/clipplic-landing

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

xzedm/clipplic-landing

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

xzedm/clipplic-landing

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

xzedm/clipplic-landing

Extract design primitives from a public website and generate starter token files for your project.

xzedm/clipplic-landing

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code', 'convert this modal/dialog/drawer/panel to Figma'. This is the preferred workflow skill whenever the user wants to build or update a full page, modal, dialog, drawer, sidebar, panel, or any composed multi-section view in Figma from code or a description. Discovers design system components, variables, and styles from Code Connect files, existing screens, and library search, then imports them and assembles views incrementally section-by-section using design system tokens instead of hardcoded values.

xzedm/clipplic-landing

**MANDATORY prerequisite**: you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context, e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

xzedm/clipplic-landing

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

xzedm/clipplic-landing

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications.

xzedm/clipplic-landing

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

xzedm/clipplic-landing

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

Habilidades Relacionadas