Communitygithub.com

xzedm/clipplic-landing

Despliega aplicaciones y sitios web en Vercel. Úsalo cuando el usuario solicite acciones de despliegue como 'despliega mi app', 'despliega y dame el enlace', 'publícalo en vivo' o 'crea un despliegue de vista previa'.

¿Qué es clipplic-landing?

Esta habilidad permite desplegar proyectos en Vercel de forma guiada y eficiente, priorizando siempre el mejor flujo a largo plazo: vincular el proyecto con Vercel mediante integración git. Soporta múltiples plataformas como Claude Code, claude.ai y Codex, adaptando automáticamente el método de despliegue según el estado del proyecto y el entorno. La habilidad evalúa cuatro condiciones clave (presencia de un repositorio git remoto, vinculación local con Vercel, instalación y autenticación de la CLI, y equipos disponibles) para elegir entre despliegue por git push, CLI directa, o un fallback sin autenticación usando un script. Incluye manejo de equipos, selección de alcance, y pasos detallados para vincular proyectos no vinculados. Es especialmente útil para desarrolladores que desean automatizar despliegues rápidos en Vercel sin salir del terminal o del asistente de IA, minimizando la fricción y maximizando la configuración ideal.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/deploy-to-vercel

Preguntar en tu IA favorita

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

Documentación

Desplegar en Vercel

Despliega cualquier proyecto en Vercel. Siempre despliega como vista previa (no producción) a menos que el usuario solicite explícitamente producción.

El objetivo es llevar al usuario a la mejor configuración a largo plazo: su proyecto vinculado a Vercel con despliegues mediante git push. Cada método a continuación intenta acercar al usuario más a ese estado.

Paso 1: Recopilar el estado del proyecto

Ejecuta las cuatro comprobaciones antes de decidir qué método usar:

# 1. Verificar si hay un remoto git
git remote get-url origin 2>/dev/null

# 2. Verificar si está vinculado localmente a un proyecto de Vercel (cualquier archivo significa vinculado)
cat .vercel/project.json 2>/dev/null || cat .vercel/repo.json 2>/dev/null

# 3. Verificar si la CLI de Vercel está instalada y autenticada
vercel whoami 2>/dev/null

# 4. Listar equipos disponibles (si está autenticado)
vercel teams list --format json 2>/dev/null

Selección de equipo

Si el usuario pertenece a varios equipos, presenta todos los slugs de equipo disponibles como una lista con viñetas y pregunta a cuál desplegar. Una vez que el usuario elija un equipo, continúa inmediatamente al siguiente paso, no pidas confirmación adicional.

Pasa el slug del equipo mediante --scope en todos los comandos posteriores de la CLI (vercel deploy, vercel link, vercel inspect, etc.):

vercel deploy [path] -y --no-wait --scope <team-slug>

Si el proyecto ya está vinculado (existe .vercel/project.json o .vercel/repo.json), el orgId en esos archivos determina el equipo, no es necesario preguntar de nuevo. Si solo hay un equipo (o solo una cuenta personal), omite la pregunta y úsalo directamente.

Acerca del directorio .vercel/: Un proyecto vinculado tiene:

  • .vercel/project.json: creado por vercel link (vinculación de proyecto único). Contiene projectId y orgId.
  • .vercel/repo.json: creado por vercel link --repo (vinculación basada en repositorio). Contiene orgId, remoteName y un array projects que mapea directorios a IDs de proyecto de Vercel.

Cualquiera de los dos archivos significa que el proyecto está vinculado. Verifica ambos.

NO uses vercel project inspect, vercel ls o vercel link para detectar el estado en un directorio no vinculado; sin un archivo de configuración .vercel/, mostrarán un prompt interactivo (o con --yes, vincularán silenciosamente como efecto secundario). Solo vercel whoami es seguro ejecutarlo en cualquier lugar.

Paso 2: Elegir un método de despliegue

Vinculado (existe .vercel/) + tiene remoto git → Git Push

Este es el estado ideal. El proyecto está vinculado y tiene integración git.

  1. Pregunta al usuario antes de hacer push. Nunca hagas push sin aprobación explícita:

    Este proyecto está conectado a Vercel mediante git. Puedo hacer commit y push
    para activar un despliegue. ¿Quieres que continúe?
    
  2. Haz commit y push:

    git add .
    git commit -m "deploy: <descripción de los cambios>"
    git push
    

    Vercel construye automáticamente desde el push. Las ramas que no son de producción obtienen despliegues de vista previa; la rama de producción (generalmente main) obtiene un despliegue de producción.

  3. Recupera la URL de vista previa. Si la CLI está autenticada:

    sleep 5
    vercel ls --format json
    

    La salida JSON tiene un array deployments. Encuentra la entrada más reciente. Su campo url es la URL de vista previa.

    Si la CLI no está autenticada, dile al usuario que revise el panel de Vercel o los checks de estado de commit en su proveedor git para la URL de vista previa.


Vinculado (existe .vercel/) + sin remoto git → vercel deploy

El proyecto está vinculado pero no hay repositorio git. Despliega directamente con la CLI.

vercel deploy [path] -y --no-wait

Usa --no-wait para que la CLI regrese inmediatamente con la URL del despliegue en lugar de bloquear hasta que termine la construcción (las construcciones pueden tardar). Luego verifica el estado del despliegue con:

vercel inspect <deployment-url>

Para despliegues de producción (solo si el usuario lo solicita explícitamente):

vercel deploy [path] --prod -y --no-wait

No vinculado + CLI autenticada → Vincular primero, luego desplegar

La CLI funciona pero el proyecto aún no está vinculado. Esta es la oportunidad para llevar al usuario al mejor estado.

  1. Pregunta al usuario a qué equipo desplegar. Presenta los slugs de equipo del Paso 1 como una lista con viñetas. Si solo hay un equipo (o solo una cuenta personal), omite este paso.

  2. Una vez seleccionado un equipo, continúa directamente a vincular. Dile al usuario lo que sucederá pero no pidas confirmación por separado:

    Vinculando este proyecto al equipo <team> en Vercel. Esto creará un proyecto
    de Vercel para desplegar y habilitará despliegues automáticos en futuros git push.
    
  3. Si existe un remoto git, usa vinculación basada en repositorio con el alcance del equipo seleccionado:

    vercel link --repo --scope <team-slug>
    

    Esto lee la URL del remoto git y la compara con proyectos existentes de Vercel que se despliegan desde ese repositorio. Crea .vercel/repo.json. Esto es mucho más confiable que vercel link (sin --repo), que intenta coincidir por nombre de directorio y a menudo falla cuando la carpeta local y el proyecto de Vercel tienen nombres diferentes.

    Si no hay remoto git, recurre a la vinculación estándar:

    vercel link --scope <team-slug>
    

    Esto solicita al usuario seleccionar o crear un proyecto. Crea .vercel/project.json.

  4. Luego despliega usando el mejor método disponible:

    • Si existe un remoto git → haz commit y push (ver método git push arriba)
    • Si no hay remoto git → vercel deploy [path] -y --no-wait --scope <team-slug>, luego vercel inspect <url> para verificar el estado

No vinculado + CLI no autenticada → Instalar, autenticar, vincular, desplegar

La CLI de Vercel no está configurada en absoluto.

  1. Instala la CLI (si aún no está instalada):

    npm install -g vercel
    
  2. Autentica:

    vercel login
    

    El usuario completa la autenticación en su navegador. Si se ejecuta en un entorno no interactivo donde no es posible iniciar sesión, salta al fallback sin autenticación de abajo.

  3. Pregunta a qué equipo desplegar: presenta los slugs de equipo de vercel teams list --format json como una lista con viñetas. Si solo hay un equipo / cuenta personal, omite el paso. Una vez seleccionado, continúa inmediatamente.

  4. Vincula el proyecto con el alcance del equipo seleccionado (usa --repo si existe un remoto git, de lo contrario vercel link simple):

    vercel link --repo --scope <team-slug>   # si existe remoto git
    vercel link --scope <team-slug>          # si no hay remoto git
    
  5. Despliega usando el mejor método disponible (git push si existe remoto, de lo contrario vercel deploy -y --no-wait --scope <team-slug>, luego vercel inspect <url> para verificar el estado).


Fallback sin autenticación, sandbox de claude.ai

Cuándo usarlo: Último recurso cuando la CLI no se puede instalar o autenticar en el sandbox de claude.ai. Esto no requiere autenticación. Devuelve una URL de vista previa (sitio en vivo) y una URL de reclamo (transferencia a tu cuenta de Vercel).

bash /mnt/skills/user/deploy-to-vercel/resources/deploy.sh [path]

Argumentos:

  • path - Directorio a desplegar, o un archivo .tgz (por defecto: directorio actual)

Ejemplos:

# Desplegar directorio actual
bash /mnt/skills/user/deploy-to-vercel/resources/deploy.sh

# Desplegar proyecto específico
bash /mnt/skills/user/deploy-to-vercel/resources/deploy.sh /path/to/project

# Desplegar tarball existente
bash /mnt/skills/user/deploy-to-vercel/resources/deploy.sh /path/to/project.tgz

El script detecta automáticamente el framework desde package.json, empaqueta el proyecto (excluyendo node_modules, .git, .env), lo sube y espera a que termine la construcción.

Dile al usuario: "Tu despliegue está listo en [previewUrl]. Reclámalo en [claimUrl] para gestionar tu despliegue."


Fallback sin autenticación. Sandbox de Codex

Cuándo usarlo: En el sandbox de Codex donde la CLI puede no estar autenticada. Codex se ejecuta en un entorno sandbox por defecto; prueba la CLI primero y recurre al script de despliegue si falla la autenticación.

  1. Verifica si la CLI de Vercel está instalada (no se necesita escalación para esta verificación):

    command -v vercel
    
  2. Si vercel está instalada, intenta desplegar con la CLI:

    vercel deploy [path] -y --no-wait
    
  3. Si vercel no está instalada o la CLI falla con "No existing credentials found", usa el script de fallback:

    skill_dir="<path-to-skill>"
    
    # Desplegar directorio actual
    bash "$skill_dir/resources/deploy-codex.sh"
    
    # Desplegar proyecto específico
    bash "$skill_dir/resources/deploy-codex.sh" /path/to/project
    
    # Desplegar tarball existente
    bash "$skill_dir/resources/deploy-codex.sh" /path/to/project.tgz
    

El script maneja la detección de framework, empaquetado y despliegue. Espera a que termine la construcción y devuelve JSON con previewUrl y claimUrl.

Dile al usuario: "Tu despliegue está listo en [previewUrl]. Reclámalo en [claimUrl] para gestionar tu despliegue."

Acceso de red escalado: Solo escala el comando de despliegue real si el sandbox bloquea la llamada de red (sandbox_permissions=require_escalated). No escale la verificación command -v vercel.


Notas específicas para agentes

Claude Code / agentes basados en terminal

Tienes acceso completo al shell. NO uses la ruta /mnt/skills/. Sigue el flujo de decisión anterior usando la CLI directamente.

Para el fallback sin autenticación, ejecuta el script de despliegue desde la ubicación de instalación de la habilidad:

bash ~/.claude/skills/deploy-to-vercel/resources/deploy.sh [path]

La ruta puede variar según dónde haya instalado la habilidad el usuario.

Entornos sandbox (claude.ai)

Es probable que no puedas ejecutar vercel login o git push. Ve directamente al fallback sin autenticación, sandbox de claude.ai.

Codex

Codex se ejecuta en un sandbox. Verifica primero si la CLI está disponible, luego recurre al script de despliegue. Ve al fallback sin autenticación. Sandbox de Codex.


Salida

Siempre muestra al usuario la URL de despliegue.

  • Git push: Usa vercel ls --format json para encontrar la URL de vista previa. Si la CLI no está autenticada, dile al usuario que revise el panel de Vercel o los checks de estado de commit.
  • CLI deploy: Muestra la URL devuelta por vercel deploy --no-wait. Usa vercel inspect <url> para verificar el estado de la construcción e informar al usuario.
  • Fallback sin autenticación: Muestra tanto la URL de vista previa como la URL de reclamo:
    ¡Despliegue exitoso!
    
    URL de vista previa: https://my-app-abc123.vercel.app
    URL de reclamo:      https://vercel.com/claim-deployment?code=...
    
    Visita tu sitio en la URL de vista previa.
    Para transferir este despliegue a tu cuenta de Vercel, visita la URL de reclamo.
    

No hagas curl ni consultes la URL desplegada para verificar que funciona. Solo devuelve el enlace.


Solución de problemas

Error de Egreso de Red (claude.ai)

Si el despliegue falla debido a restricciones de red en claude.ai, dile al usuario:

El despliegue falló debido a restricciones de red. Para solucionarlo:

1. Ve a https://claude.ai/settings/capabilities
2. Agrega *.vercel.com a los dominios permitidos
3. Intenta desplegar de nuevo

Acceso de Red Escalado (Codex / entornos sandbox)

Si el despliegue falla debido a problemas de red (timeouts, errores de DNS, restablecimientos de conexión) en un entorno sandbox, vuelve a ejecutarlo con permisos escalados (sandbox_permissions=require_escalated). No escale la verificación inicial de disponibilidad de la CLI, solo escala el comando de despliegue real.

Ejemplo de indicación al usuario:

El despliegue necesita acceso de red escalado para desplegar en Vercel. Puedo
volver a ejecutar el comando con permisos escalados, ¿quieres que continúe?

Fallo de Autenticación de CLI

Si vercel login o vercel deploy falla con errores de autenticación, recurre al script de despliegue sin autenticación (variante de claude.ai o Codex, según el entorno).

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

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)

xzedm/clipplic-landing

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic. A promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Skills relacionados