Communitygithub.com

xzedm/clipplic-landing

Implante aplicações e sites na Vercel. Use quando o usuário solicitar ações de implantação como "implantar meu app", "implantar e me dar o link", "publicar isso ao vivo" ou "criar uma pré-visualização de implantação".

O que é clipplic-landing?

Esta skill permite que agentes de IA (como Claude Code, Cursor, Codex, etc.) implantem projetos na Vercel com um fluxo de decisão inteligente que prioriza o setup de longo prazo: conectar o projeto à Vercel com deploys via git push. Ela executa quatro verificações iniciais (git remote, linked project, CLI autenticado, times disponíveis) para determinar o melhor método de implantação: git push (quando o projeto já está linked e tem remote), `vercel deploy` diretamente (quando linked mas sem git remote), ou link primeiro e depois deploy. Caso a CLI não esteja disponível ou autenticada, a skill oferece um fallback sem autenticação usando scripts shell para ambientes sandbox como claude.ai e Codex, retornando uma URL de preview e uma URL de claim. A skill gerencia times, produção (apenas quando explicitamente solicitado) e pré-visualização, sempre mostrando ao usuário a URL final da implantação.

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

Perguntar na sua IA favorita

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

Documentação

Implantar na Vercel

Implante qualquer projeto na Vercel. Sempre implante como preview (não produção) a menos que o usuário peça explicitamente por produção.

O objetivo é colocar o usuário na melhor configuração de longo prazo: seu projeto linked à Vercel com deploys via git push. Cada método abaixo tenta mover o usuário mais perto desse estado.

Etapa 1: Coletar o Estado do Projeto

Execute todas as quatro verificações antes de decidir qual método usar:

# 1. Verificar se há um git remote
git remote get-url origin 2>/dev/null

# 2. Verificar se está linked localmente a um projeto Vercel (qualquer arquivo significa linked)
cat .vercel/project.json 2>/dev/null || cat .vercel/repo.json 2>/dev/null

# 3. Verificar se a CLI da Vercel está instalada e autenticada
vercel whoami 2>/dev/null

# 4. Listar times disponíveis (se autenticado)
vercel teams list --format json 2>/dev/null

Seleção de time

Se o usuário pertence a vários times, apresente todos os slugs de time disponíveis como uma lista com marcadores e pergunte para qual time implantar. Quando o usuário escolher um time, prossiga imediatamente para a próxima etapa, sem pedir confirmação adicional.

Passe o slug do time via --scope em todos os comandos subsequentes da CLI (vercel deploy, vercel link, vercel inspect, etc.):

vercel deploy [caminho] -y --no-wait --scope <slug-do-time>

Se o projeto já estiver linked (.vercel/project.json ou .vercel/repo.json existe), o orgId nesses arquivos determina o time, não é necessário perguntar novamente. Se houver apenas um time (ou apenas uma conta pessoal), pule o prompt e use diretamente.

Sobre o diretório .vercel/: Um projeto linked tem:

  • .vercel/project.json: criado por vercel link (linking de projeto único). Contém projectId e orgId.
  • .vercel/repo.json: criado por vercel link --repo (linking baseado em repositório). Contém orgId, remoteName e um array projects mapeando diretórios para IDs de projetos Vercel.

Qualquer um dos arquivos significa que o projeto está linked. Verifique ambos.

NÃO use vercel project inspect, vercel ls ou vercel link para detectar o estado em um diretório não linked; sem um arquivo .vercel/, eles solicitarão interativamente (ou com --yes, farão o linked silenciosamente como efeito colateral). Apenas vercel whoami é seguro de executar em qualquer lugar.

Etapa 2: Escolher um Método de Implantação

Linked (.vercel/ existe) + tem git remote → Git Push

Este é o estado ideal. O projeto está linked e tem integração com git.

  1. Pergunte ao usuário antes de fazer push. Nunca faça push sem aprovação explícita:

    Este projeto está conectado à Vercel via git. Posso commitar e fazer push para
    acionar uma implantação. Deseja prosseguir?
    
  2. Commit e push:

    git add .
    git commit -m "deploy: <descrição das alterações>"
    git push
    

    A Vercel compila automaticamente a partir do push. Branches não produção recebem implantações de preview; a branch de produção (geralmente main) recebe uma implantação de produção.

  3. Recuperar a URL de preview. Se a CLI estiver autenticada:

    sleep 5
    vercel ls --format json
    

    A saída JSON tem um array deployments. Encontre a entrada mais recente. O campo url é a URL de preview.

    Se a CLI não estiver autenticada, diga ao usuário para verificar o painel da Vercel ou as verificações de status de commit no provedor git para a URL de preview.


Linked (.vercel/ existe) + sem git remote → vercel deploy

O projeto está linked mas não há repositório git. Implante diretamente com a CLI.

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

Use --no-wait para que a CLI retorne imediatamente com a URL de implantação em vez de bloquear até o build terminar (os builds podem demorar um pouco). Em seguida, verifique o status da implantação com:

vercel inspect <url-de-implantação>

Para implantações de produção (apenas se o usuário pedir explicitamente):

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

Não linked + CLI autenticada → Link primeiro, depois deploy

A CLI está funcionando mas o projeto ainda não está linked. Esta é a oportunidade de colocar o usuário no melhor estado.

  1. Pergunte ao usuário para qual time implantar. Apresente os slugs de time da Etapa 1 como uma lista com marcadores. Se houver apenas um time (ou apenas uma conta pessoal), pule esta etapa.

  2. Uma vez que um time for selecionado, prossiga diretamente para o linked. Diga ao usuário o que vai acontecer, mas não peça confirmação separada:

    Vinculando este projeto ao <nome do time> na Vercel. Isso criará um projeto Vercel
    para implantar e ativará implantações automáticas em futuros pushes git.
    
  3. Se existir um git remote, use o linked baseado em repositório com o escopo do time selecionado:

    vercel link --repo --scope <slug-do-time>
    

    Isso lê a URL do git remote e a corresponde a projetos Vercel existentes que implantam a partir desse repositório. Cria .vercel/repo.json. Isso é muito mais confiável do que vercel link (sem --repo), que tenta corresponder pelo nome do diretório e frequentemente falha quando a pasta local e o projeto Vercel têm nomes diferentes.

    Se não houver git remote, caia para o linked padrão:

    vercel link --scope <slug-do-time>
    

    Isso solicita que o usuário selecione ou crie um projeto. Cria .vercel/project.json.

  4. Em seguida, implante usando o melhor método disponível:

    • Se existir um git remote → commit e push (veja o método git push acima)
    • Se não houver git remote → vercel deploy [caminho] -y --no-wait --scope <slug-do-time>, depois vercel inspect <url> para verificar o status

Não linked + CLI não autenticada → Instalar, autenticar, link, deploy

A CLI da Vercel não está configurada.

  1. Instalar a CLI (se ainda não estiver instalada):

    npm install -g vercel
    
  2. Autenticar:

    vercel login
    

    O usuário completa a autenticação no navegador. Se estiver em um ambiente não interativo onde o login não é possível, pule para a solução alternativa sem autenticação abaixo.

  3. Perguntar para qual time implantar: apresente os slugs de time de vercel teams list --format json como uma lista com marcadores. Se apenas um time/conta pessoal, pule. Uma vez selecionado, prossiga imediatamente.

  4. Link do projeto com o escopo do time selecionado (use --repo se existir um git remote, vercel link padrão caso contrário):

    vercel link --repo --scope <slug-do-time>   # se existir git remote
    vercel link --scope <slug-do-time>          # se não houver git remote
    
  5. Implantar usando o melhor método disponível (git push se existir remote, caso contrário vercel deploy -y --no-wait --scope <slug-do-time>, depois vercel inspect <url> para verificar o status).


Solução Alternativa Sem Autenticação, sandbox claude.ai

Quando usar: Último recurso quando a CLI não puder ser instalada ou autenticada no sandbox do claude.ai. Isso não requer autenticação. Retorna uma URL de Preview (site ao vivo) e uma URL de Claim (transferência para sua conta Vercel).

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

Argumentos:

  • caminho - Diretório a implantar, ou um arquivo .tgz (padrão é o diretório atual)

Exemplos:

# Implantar diretório atual
bash /mnt/skills/user/deploy-to-vercel/resources/deploy.sh

# Implantar projeto específico
bash /mnt/skills/user/deploy-to-vercel/resources/deploy.sh /caminho/para/projeto

# Implantar tarball existente
bash /mnt/skills/user/deploy-to-vercel/resources/deploy.sh /caminho/para/projeto.tgz

O script detecta automaticamente o framework a partir de package.json, empacota o projeto (excluindo node_modules, .git, .env), envia-o e aguarda a conclusão do build.

Informe o usuário: "Sua implantação está pronta em [previewUrl]. Reivindique-a em [claimUrl] para gerenciar sua implantação."


Solução Alternativa Sem Autenticação. Sandbox Codex

Quando usar: No sandbox do Codex onde a CLI pode não estar autenticada. O Codex roda em um ambiente sandbox por padrão; tente a CLI primeiro e caia para o script de deploy se a autenticação falhar.

  1. Verificar se a CLI da Vercel está instalada (nenhuma escalação necessária para esta verificação):

    command -v vercel
    
  2. Se vercel estiver instalado, tente implantar com a CLI:

    vercel deploy [caminho] -y --no-wait
    
  3. Se vercel não estiver instalado, ou se a CLI falhar com "No existing credentials found", use o script de solução alternativa:

    skill_dir="<caminho-para-skill>"
    
    # Implantar diretório atual
    bash "$skill_dir/resources/deploy-codex.sh"
    
    # Implantar projeto específico
    bash "$skill_dir/resources/deploy-codex.sh" /caminho/para/projeto
    
    # Implantar tarball existente
    bash "$skill_dir/resources/deploy-codex.sh" /caminho/para/projeto.tgz
    

O script lida com detecção de framework, empacotamento e implantação. Ele aguarda a conclusão do build e retorna JSON com previewUrl e claimUrl.

Informe o usuário: "Sua implantação está pronta em [previewUrl]. Reivindique-a em [claimUrl] para gerenciar sua implantação."

Acesso de rede escalado: Apenas escale o comando de deploy real se o sandbox bloquear a chamada de rede (sandbox_permissions=require_escalated). Não escale a verificação command -v vercel.


Notas Específicas do Agente

Claude Code / agentes baseados em terminal

Você tem acesso completo ao shell. NÃO use o caminho /mnt/skills/. Siga o fluxo de decisão acima usando a CLI diretamente.

Para a solução alternativa sem autenticação, execute o script de deploy a partir do local de instalação da skill:

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

O caminho pode variar dependendo de onde o usuário instalou a skill.

Ambientes sandbox (claude.ai)

Você provavelmente não pode executar vercel login ou git push. Vá diretamente para a solução alternativa sem autenticação, sandbox claude.ai.

Codex

O Codex roda em um sandbox. Verifique primeiro se a CLI está disponível, então caia para o script de deploy. Vá para a solução alternativa sem autenticação. Sandbox Codex.


Saída

Sempre mostre ao usuário a URL de implantação.

  • Git push: Use vercel ls --format json para encontrar a URL de preview. Se a CLI não estiver autenticada, diga ao usuário para verificar o painel da Vercel ou as verificações de status de commit.
  • CLI deploy: Mostre a URL retornada por vercel deploy --no-wait. Use vercel inspect <url> para verificar o status do build e relatá-lo ao usuário.
  • Solução alternativa sem autenticação: Mostre tanto a URL de preview quanto a URL de claim:
    Implantação bem-sucedida!
    
    URL de Preview: https://meu-app-abc123.vercel.app
    URL de Claim:   https://vercel.com/claim-deployment?code=...
    
    Veja seu site na URL de Preview.
    Para transferir esta implantação para sua conta Vercel, visite a URL de Claim.
    

Não faça curl ou fetch da URL implantada para verificar se funciona. Apenas retorne o link.


Solução de Problemas

Erro de Egress de Rede (claude.ai)

Se a implantação falhar devido a restrições de rede no claude.ai, informe o usuário:

Falha na implantação devido a restrições de rede. Para corrigir:

1. Vá para https://claude.ai/settings/capabilities
2. Adicione *.vercel.com aos domínios permitidos
3. Tente implantar novamente

Acesso de Rede Escalado (Codex / ambientes sandbox)

Se a implantação falhar devido a problemas de rede (timeouts, erros de DNS, conexões reiniciadas) em um ambiente sandbox, execute novamente com permissões escaladas (sandbox_permissions=require_escalated). Não escale a verificação inicial de disponibilidade da CLI, apenas escale o comando de deploy real.

Exemplo de orientação ao usuário:

O deploy precisa de acesso de rede escalado para implantar na Vercel. Posso executar novamente
   o comando com permissões escaladas, deseja prosseguir?

Falha de Autenticação da CLI

Se vercel login ou vercel deploy falhar com erros de autenticação, caia para o script de deploy sem autenticação (variante claude.ai ou Codex, dependendo do ambiente).

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.

Habilidades Relacionadas