Communitygithub.com

xzedm/clipplic-landing

Déployer des applications et sites web sur Vercel. À utiliser lorsque l'utilisateur demande des actions de déploiement comme « déploie mon app », « déploie et donne-moi le lien », « mets ça en ligne » ou « crée un déploiement de prévisualisation ».

Qu'est-ce que clipplic-landing ?

Cette compétence permet de déployer n'importe quel projet sur Vercel, que ce soit en prévisualisation ou en production, via plusieurs méthodes adaptées au contexte de l'utilisateur. Elle détecte automatiquement l'état du projet (lié ou non à Vercel, existence d'un dépôt Git, authentification CLI) et choisit la meilleure approche : poussée Git idéale, déploiement CLI direct, ou script sans authentification pour les environnements restreints comme claude.ai ou Codex. La compétence gère également la sélection d'équipe, la liaison du projet, la vérification du statut de construction, et fournit l'URL de déploiement finale. En cas d'échec, elle propose des solutions de contournement comme l'escalade des permissions réseau ou l'ajout de domaines autorisés.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Déployer sur Vercel

Déployez n'importe quel projet sur Vercel. Toujours déployer en prévisualisation (pas en production) sauf si l'utilisateur demande explicitement la production.

L'objectif est d'offrir à l'utilisateur la meilleure configuration à long terme : son projet lié à Vercel avec des déploiements par poussée git. Chaque méthode ci-dessous essaie de rapprocher l'utilisateur de cet état.

Étape 1 : Récupérer l'état du projet

Exécutez les quatre vérifications avant de choisir la méthode à utiliser :

# 1. Vérifier s'il existe un dépôt distant git
git remote get-url origin 2>/dev/null

# 2. Vérifier si le projet est lié localement à un projet Vercel (l'un ou l'autre fichier signifie qu'il est lié)
cat .vercel/project.json 2>/dev/null || cat .vercel/repo.json 2>/dev/null

# 3. Vérifier si la CLI Vercel est installée et authentifiée
vercel whoami 2>/dev/null

# 4. Lister les équipes disponibles (si authentifié)
vercel teams list --format json 2>/dev/null

Sélection de l'équipe

Si l'utilisateur appartient à plusieurs équipes, présentez tous les slugs d'équipe disponibles sous forme de liste à puces et demandez sur laquelle déployer. Une fois que l'utilisateur a choisi une équipe, passez immédiatement à l'étape suivante, ne demandez pas de confirmation supplémentaire.

Transmettez le slug de l'équipe via --scope sur toutes les commandes CLI suivantes (vercel deploy, vercel link, vercel inspect, etc.) :

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

Si le projet est déjà lié (.vercel/project.json ou .vercel/repo.json existe), le orgId dans ces fichiers détermine l'équipe, inutile de redemander. S'il n'y a qu'une seule équipe (ou juste un compte personnel), ignorez l'invite et utilisez-la directement.

À propos du répertoire .vercel/ : Un projet lié possède soit :

  • .vercel/project.json : créé par vercel link (liaison de projet unique). Contient projectId et orgId.
  • .vercel/repo.json : créé par vercel link --repo (liaison basée sur le dépôt). Contient orgId, remoteName, et un tableau projects mappant des répertoires aux ID de projet Vercel.

L'un ou l'autre fichier signifie que le projet est lié. Vérifiez les deux.

N'utilisez PAS vercel project inspect, vercel ls, ou vercel link pour détecter l'état dans un répertoire non lié ; sans configuration .vercel/, ils demanderont une interaction interactive (ou avec --yes, lieront silencieusement comme effet secondaire). Seul vercel whoami peut être exécuté en toute sécurité n'importe où.

Étape 2 : Choisir une méthode de déploiement

Lié (.vercel/ existe) + dépôt git distant → Poussée Git

C'est l'état idéal. Le projet est lié et dispose d'une intégration git.

  1. Demandez à l'utilisateur avant de pousser. Ne poussez jamais sans approbation explicite :

    Ce projet est connecté à Vercel via git. Je peux faire un commit et pousser pour
    déclencher un déploiement. Voulez-vous continuer ?
    
  2. Commiter et pousser :

    git add .
    git commit -m "deploy: <description des changements>"
    git push
    

    Vercel construit automatiquement à partir de la poussée. Les branches non production obtiennent des déploiements de prévisualisation ; la branche de production (généralement main) obtient un déploiement de production.

  3. Récupérer l'URL de prévisualisation. Si la CLI est authentifiée :

    sleep 5
    vercel ls --format json
    

    La sortie JSON contient un tableau deployments. Trouvez la dernière entrée. Son champ url est l'URL de prévisualisation.

    Si la CLI n'est pas authentifiée, dites à l'utilisateur de vérifier le tableau de bord Vercel ou les vérifications d'état du commit sur leur fournisseur git pour l'URL de prévisualisation.


Lié (.vercel/ existe) + pas de dépôt git distant → vercel deploy

Le projet est lié mais il n'y a pas de dépôt git. Déployez directement avec la CLI.

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

Utilisez --no-wait pour que la CLI revienne immédiatement avec l'URL de déploiement plutôt que de bloquer jusqu'à la fin de la construction (les constructions peuvent prendre du temps). Vérifiez ensuite l'état du déploiement avec :

vercel inspect <deployment-url>

Pour les déploiements de production (uniquement si l'utilisateur le demande explicitement) :

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

Non lié + CLI authentifiée → Lier d'abord, puis déployer

La CLI fonctionne mais le projet n'est pas encore lié. C'est l'occasion de mettre l'utilisateur dans le meilleur état.

  1. Demandez à l'utilisateur sur quelle équipe déployer. Présentez les slugs d'équipe de l'Étape 1 sous forme de liste à puces. S'il n'y a qu'une seule équipe (ou juste un compte personnel), ignorez cette étape.

  2. Une fois l'équipe sélectionnée, passez directement à la liaison. Dites à l'utilisateur ce qui va se passer mais ne demandez pas de confirmation séparée :

    Liaison de ce projet à <nom de l'équipe> sur Vercel. Cela créera un projet Vercel
    pour déployer et activera les déploiements automatiques lors des futures poussées git.
    
  3. Si un dépôt git distant existe, utilisez la liaison basée sur le dépôt avec le scope de l'équipe sélectionnée :

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

    Cela lit l'URL du dépôt git distant et la fait correspondre aux projets Vercel existants qui déploient à partir de ce dépôt. Cela crée .vercel/repo.json. C'est beaucoup plus fiable que vercel link (sans --repo), qui essaie de faire correspondre par nom de répertoire et échoue souvent lorsque le dossier local et le projet Vercel ont des noms différents.

    S'il n'y a pas de dépôt git distant, revenez à la liaison standard :

    vercel link --scope <team-slug>
    

    Cela invite l'utilisateur à sélectionner ou créer un projet. Cela crée .vercel/project.json.

  4. Ensuite, déployez en utilisant la meilleure méthode disponible :

    • Si un dépôt git distant existe → commiter et pousser (voir la méthode de poussée git ci-dessus)
    • Si pas de dépôt git distant → vercel deploy [path] -y --no-wait --scope <team-slug>, puis vercel inspect <url> pour vérifier l'état

Non lié + CLI non authentifiée → Installer, authentifier, lier, déployer

La CLI Vercel n'est pas du tout configurée.

  1. Installer la CLI (si pas déjà installée) :

    npm install -g vercel
    
  2. S'authentifier :

    vercel login
    

    L'utilisateur termine l'authentification dans son navigateur. Si l'environnement est non interactif et que la connexion est impossible, passez à la solution de repli sans authentification ci-dessous.

  3. Demander sur quelle équipe déployer : présentez les slugs d'équipe de vercel teams list --format json sous forme de liste à puces. Si une seule équipe / compte personnel, ignorez. Une fois sélectionné, passez immédiatement à la suite.

  4. Lier le projet avec le scope de l'équipe sélectionnée (utilisez --repo si un dépôt git distant existe, vercel link simple sinon) :

    vercel link --repo --scope <team-slug>   # si dépôt git distant existe
    vercel link --scope <team-slug>          # si pas de dépôt git distant
    
  5. Déployer en utilisant la meilleure méthode disponible (poussée git si dépôt distant existe, sinon vercel deploy -y --no-wait --scope <team-slug>, puis vercel inspect <url> pour vérifier l'état).


Solution de repli sans authentification, sandbox claude.ai

Quand l'utiliser : En dernier recours lorsque la CLI ne peut pas être installée ou authentifiée dans le sandbox claude.ai. Cela ne nécessite aucune authentification. Cela renvoie une URL de prévisualisation (site en direct) et une URL de réclamation (transfert vers votre compte Vercel).

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

Arguments :

  • path - Répertoire à déployer, ou un fichier .tgz (par défaut, le répertoire courant)

Exemples :

# Déployer le répertoire courant
bash /mnt/skills/user/deploy-to-vercel/resources/deploy.sh

# Déployer un projet spécifique
bash /mnt/skills/user/deploy-to-vercel/resources/deploy.sh /path/to/project

# Déployer une archive existante
bash /mnt/skills/user/deploy-to-vercel/resources/deploy.sh /path/to/project.tgz

Le script détecte automatiquement le framework à partir de package.json, empaquette le projet (en excluant node_modules, .git, .env), le télécharge et attend la fin de la construction.

Dites à l'utilisateur : « Votre déploiement est prêt à l'adresse [previewUrl]. Réclamez-le à l'adresse [claimUrl] pour gérer votre déploiement. »


Solution de repli sans authentification, sandbox Codex

Quand l'utiliser : Dans le sandbox Codex où la CLI peut ne pas être authentifiée. Codex s'exécute dans un environnement sandboxé par défaut, essayez d'abord la CLI, et revenez au script de déploiement si l'authentification échoue.

  1. Vérifier si la CLI Vercel est installée (aucune escalade nécessaire pour cette vérification) :

    command -v vercel
    
  2. Si vercel est installé, essayez de déployer avec la CLI :

    vercel deploy [path] -y --no-wait
    
  3. Si vercel n'est pas installé, ou si la CLI échoue avec « No existing credentials found », utilisez le script de repli :

    skill_dir="<path-to-skill>"
    
    # Déployer le répertoire courant
    bash "$skill_dir/resources/deploy-codex.sh"
    
    # Déployer un projet spécifique
    bash "$skill_dir/resources/deploy-codex.sh" /path/to/project
    
    # Déployer une archive existante
    bash "$skill_dir/resources/deploy-codex.sh" /path/to/project.tgz
    

Le script gère la détection du framework, l'empaquetage et le déploiement. Il attend la fin de la construction et renvoie du JSON avec previewUrl et claimUrl.

Dites à l'utilisateur : « Votre déploiement est prêt à l'adresse [previewUrl]. Réclamez-le à l'adresse [claimUrl] pour gérer votre déploiement. »

Accès réseau avec escalade : N'escaladez que la commande de déploiement réelle si le sandboxing bloque l'appel réseau (sandbox_permissions=require_escalated). N'escaladez pas la vérification command -v vercel.


Notes spécifiques à l'agent

Claude Code / agents basés sur le terminal

Vous avez un accès complet au shell. N'utilisez PAS le chemin /mnt/skills/. Suivez le flux de décision ci-dessus en utilisant directement la CLI.

Pour la solution de repli sans authentification, exécutez le script de déploiement depuis l'emplacement d'installation de la compétence :

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

Le chemin peut varier selon l'endroit où l'utilisateur a installé la compétence.

Environnements sandboxés (claude.ai)

Vous ne pouvez probablement pas exécuter vercel login ou git push. Allez directement à la solution de repli sans authentification, sandbox claude.ai.

Codex

Codex s'exécute dans un sandbox. Vérifiez d'abord si la CLI est disponible, puis revenez au script de déploiement. Allez à la solution de repli sans authentification, sandbox Codex.


Sortie

Affichez toujours l'URL de déploiement à l'utilisateur.

  • Poussée Git : Utilisez vercel ls --format json pour trouver l'URL de prévisualisation. Si la CLI n'est pas authentifiée, dites à l'utilisateur de vérifier le tableau de bord Vercel ou les vérifications d'état du commit.
  • Déploiement CLI : Affichez l'URL renvoyée par vercel deploy --no-wait. Utilisez vercel inspect <url> pour vérifier l'état de la construction et le rapporter à l'utilisateur.
  • Solution de repli sans authentification : Affichez à la fois l'URL de prévisualisation et l'URL de réclamation :
    Déploiement réussi !
    
    URL de prévisualisation : https://my-app-abc123.vercel.app
    URL de réclamation :   https://vercel.com/claim-deployment?code=...
    
    Consultez votre site à l'URL de prévisualisation.
    Pour transférer ce déploiement vers votre compte Vercel, visitez l'URL de réclamation.
    

N'utilisez pas curl ou ne récupérez pas l'URL déployée pour vérifier qu'elle fonctionne. Renvoyez simplement le lien.


Résolution des problèmes

Erreur de sortie réseau (claude.ai)

Si le déploiement échoue en raison de restrictions réseau sur claude.ai, dites à l'utilisateur :

Le déploiement a échoué en raison de restrictions réseau. Pour résoudre ce problème :

1. Allez sur https://claude.ai/settings/capabilities
2. Ajoutez *.vercel.com aux domaines autorisés
3. Essayez de déployer à nouveau

Accès réseau avec escalade (Codex / environnements sandboxés)

Si le déploiement échoue en raison de problèmes réseau (timeouts, erreurs DNS, réinitialisations de connexion) dans un environnement sandboxé, relancez avec des permissions escaladées (sandbox_permissions=require_escalated). N'escaladez pas la vérification initiale de disponibilité de la CLI, escaladez uniquement la commande de déploiement réelle.

Exemple de conseil à l'utilisateur :

Le déploiement nécessite un accès réseau avec escalade pour déployer sur Vercel. Je peux relancer
la commande avec des permissions escaladées, voulez-vous continuer ?

Échec d'authentification CLI

Si vercel login ou vercel deploy échoue avec des erreurs d'authentification, revenez au script de déploiement sans authentification (variante claude.ai ou Codex, selon l'environnement).

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 associés