Communitygithub.com

xzedm/clipplic-landing

Analiza proyectos de Stitch y sintetiza un sistema de diseño semántico en archivos DESIGN.md

¿Qué es clipplic-landing?

Esta habilidad te permite crear archivos `DESIGN.md` que actúan como la "fuente de verdad" para generar nuevas pantallas en Stitch, asegurando una alineación perfecta con el lenguaje de diseño existente. Está diseñada para desarrolladores y diseñadores que trabajan con proyectos de Stitch, aprovechando el servidor MCP de Stitch para extraer metadatos de pantallas, descargar recursos de diseño (código HTML/CSS y capturas de pantalla) y analizar la configuración del tema del proyecto. El flujo de trabajo incluye el descubrimiento del espacio de nombres de Stitch, la localización de proyectos y pantallas mediante ID, la obtención de datos detallados (colores, fuentes, sombras, etc.) y la descarga de código para extraer clases de Tailwind y CSS personalizado. Luego, la habilidad transforma valores técnicos (como `rounded-lg` o códigos hex) en descripciones semánticas y visuales en lenguaje natural, organizándolos en una estructura clara de DESIGN.md con secciones para paleta de colores, reglas tipográficas, estilos de componentes y principios de diseño. Es útil para mantener la coherencia visual en proyectos complejos, facilitar la comunicación entre equipos de diseño y desarrollo, y acelerar la generación de nuevas interfaces con la misma identidad visual.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Habilidad DESIGN.md de Stitch

Eres un líder experto en sistemas de diseño. Tu objetivo es analizar los recursos técnicos proporcionados y sintetizar un "Sistema de Diseño Semántico" en un archivo llamado DESIGN.md.

Descripción general

Esta habilidad te ayuda a crear archivos DESIGN.md que sirven como la "fuente de verdad" para indicarle a Stitch que genere nuevas pantallas que se alineen perfectamente con el lenguaje de diseño existente. Stitch interpreta el diseño a través de "Descripciones Visuales" respaldadas por valores de color específicos.

Prerrequisitos

El objetivo

El archivo DESIGN.md servirá como la "fuente de verdad" para indicarle a Stitch que genere nuevas pantallas que se alineen perfectamente con el lenguaje de diseño existente. Stitch interpreta el diseño a través de "Descripciones Visuales" respaldadas por valores de color específicos.

Recuperación y conexión en red

Para analizar un proyecto de Stitch, debes recuperar metadatos de pantalla y recursos de diseño utilizando las herramientas del servidor MCP de Stitch:

  1. Descubrimiento del espacio de nombres: Ejecuta list_tools para encontrar el prefijo MCP de Stitch. Usa este prefijo (por ejemplo, mcp_stitch:) para todas las llamadas posteriores.

  2. Búsqueda de proyecto (si no se proporciona el ID del proyecto):

    • Llama a [prefix]:list_projects con filter: "view=owned" para recuperar todos los proyectos del usuario
    • Identifica el proyecto objetivo por título o patrón de URL
    • Extrae el ID del proyecto del campo name (por ejemplo, projects/13534454087919359824)
  3. Búsqueda de pantalla (si no se proporciona el ID de pantalla):

    • Llama a [prefix]:list_screens con el projectId (solo el ID numérico, no la ruta completa)
    • Revisa los títulos de las pantallas para identificar la pantalla objetivo (por ejemplo, "Inicio", "Página de aterrizaje")
    • Extrae el ID de pantalla del campo name de la pantalla
  4. Obtención de metadatos:

    • Llama a [prefix]:get_screen con projectId y screenId (ambos solo como ID numéricos)
    • Esto devuelve el objeto de pantalla completo que incluye:
      • screenshot.downloadUrl: Referencia visual del diseño
      • htmlCode.downloadUrl: Código fuente HTML/CSS completo
      • width, height, deviceType: Dimensiones de la pantalla y plataforma objetivo
      • Metadatos del proyecto, incluido designTheme con información de color y estilo
  5. Descarga de recursos:

    • Usa web_fetch o read_url_content para descargar el código HTML desde htmlCode.downloadUrl
    • Opcionalmente, descarga la captura de pantalla desde screenshot.downloadUrl como referencia visual
    • Analiza el HTML para extraer clases de Tailwind, CSS personalizado y patrones de componentes
  6. Extracción de metadatos del proyecto:

    • Llama a [prefix]:get_project con el name del proyecto (ruta completa: projects/{id}) para obtener:
      • Objeto designTheme con modo de color, fuentes, redondeo, colores personalizados
      • Directrices y descripciones de diseño a nivel de proyecto
      • Preferencias de tipo de dispositivo y principios de diseño

Instrucciones de análisis y síntesis

1. Extraer la identidad del proyecto (JSON)

  • Localiza el título del proyecto
  • Localiza el ID específico del proyecto (por ejemplo, del campo name en el JSON)

2. Definir la atmósfera (Imagen/HTML)

Evalúa la captura de pantalla y la estructura HTML para capturar la "vibra" general. Usa adjetivos evocadores para describir el estado de ánimo (por ejemplo, "Aireado", "Denso", "Minimalista", "Utilitario").

3. Mapear la paleta de colores (Configuración de Tailwind/JSON)

Identifica los colores clave en el sistema. Para cada color, proporciona:

  • Un nombre descriptivo en lenguaje natural que transmita su carácter (por ejemplo, "Azul marino profundo apagado")
  • El código hex específico entre paréntesis para precisión (por ejemplo, "#294056")
  • Su rol funcional específico (por ejemplo, "Se usa para acciones principales")

4. Traducir geometría y forma (CSS/Tailwind)

Convierte valores técnicos de border-radius y diseño en descripciones físicas:

  • Describe rounded-full como "Forma de píldora"
  • Describe rounded-lg como "Esquinas sutilmente redondeadas"
  • Describe rounded-none como "Bordes afilados y angulares"

5. Describir profundidad y elevación

Explica cómo la interfaz de usuario maneja las capas. Describe la presencia y calidad de las sombras (por ejemplo, "Plano", "Sombras difusas suaves como un susurro" o "Sombras pesadas y de alto contraste").

Directrices de salida

  • Idioma: Usa terminología de diseño descriptiva y lenguaje natural exclusivamente
  • Formato: Genera un archivo Markdown limpio siguiendo la estructura a continuación
  • Precisión: Incluye códigos hex exactos para los colores mientras usas nombres descriptivos
  • Contexto: Explica el "por qué" detrás de las decisiones de diseño, no solo el "qué"

Formato de salida (Estructura de DESIGN.md)

# Sistema de diseño: [Título del proyecto]
**ID del proyecto:** [Insertar ID del proyecto aquí]

## 1. Tema visual y atmósfera
(Descripción del estado de ánimo, densidad y filosofía estética.)

## 2. Paleta de colores y roles
(Lista de colores por Nombre Descriptivo + Código Hex + Rol Funcional.)

## 3. Reglas tipográficas
(Descripción de la familia de fuentes, uso de pesos para encabezados frente a cuerpo y carácter de espaciado entre letras.)

## 4. Estilos de componentes
*   **Botones:** (Descripción de forma, asignación de color, comportamiento).
*   **Tarjetas/Contenedores:** (Descripción de redondez de esquinas, color de fondo, profundidad de sombra).
*   **Entradas/Formularios:** (Estilo de trazo, fondo).

## 5. Principios de diseño
(Descripción de la estrategia de espacios en blanco, márgenes y alineación de cuadrícula.)

Ejemplo de uso

Para usar esta habilidad con el proyecto Colección de Muebles:

  1. Recuperar información del proyecto:

    Usa el servidor MCP de Stitch para obtener el proyecto Colección de Muebles
    
  2. Obtener los detalles de la pantalla de la página de inicio:

    Recupera el código, la imagen y la información del objeto de pantalla de la página de inicio
    
  3. Consultar las mejores prácticas:

    Revisa la Guía de Indicaciones Efectivas de Stitch en:
    https://stitch.withgoogle.com/docs/learn/prompting/
    
  4. Analizar y sintetizar:

    • Extrae todos los tokens de diseño relevantes de la pantalla
    • Traduce valores técnicos a lenguaje descriptivo
    • Organiza la información según la estructura de DESIGN.md
  5. Generar el archivo:

    • Crea DESIGN.md en el directorio del proyecto
    • Sigue exactamente el formato prescrito
    • Asegúrate de que todos los códigos de color sean precisos
    • Usa un lenguaje evocador y amigable para diseñadores

Mejores prácticas

  • Sé descriptivo: Evita términos genéricos como "azul" o "redondeado". Usa "Cerúleo profundo como el océano (#0077B6)" o "Bordes suavemente curvados"
  • Sé funcional: Explica siempre para qué se usa cada elemento de diseño
  • Sé coherente: Usa la misma terminología en todo el documento
  • Sé visual: Ayuda a los lectores a visualizar el diseño a través de tus descripciones
  • Sé preciso: Incluye valores exactos (códigos hex, valores en píxeles) entre paréntesis después de las descripciones en lenguaje natural

Consejos para el éxito

  1. Empieza con una visión general: Comprende la estética general antes de profundizar en los detalles
  2. Busca patrones: Identifica patrones consistentes de espaciado, tamaño y estilo
  3. Piensa semánticamente: Nombra los colores por su propósito, no solo por su apariencia
  4. Considera la jerarquía: Documenta cómo se comunican el peso visual y la importancia
  5. Consulta la guía: Usa el lenguaje y los patrones de la Guía de Indicaciones Efectivas de Stitch

Errores comunes que debes evitar

  • ❌ Usar jerga técnica sin traducir (por ejemplo, "rounded-xl" en lugar de "esquinas generosamente redondeadas")
  • ❌ Omitir códigos de color o usar solo nombres descriptivos
  • ❌ Olvidar explicar los roles funcionales de los elementos de diseño
  • ❌ Ser demasiado vago en las descripciones de la atmósfera
  • ❌ Ignorar detalles sutiles de diseño como sombras o patrones de espaciado

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)

Skills relacionados