Synthèse automatique
Crée un nouvel endpoint API serverless Vercel pour NuxChain en suivant les conventions du projet : TypeScript, cache, limitation de débit, CORS, et enregistrement dans vercel.json.
Points forts
- Automatise la création d'endpoints avec toutes les bonnes pratiques intégrées
- Gère automatiquement les prérequis CORS, cache, et gestion d'erreurs
- S'assure que l'endpoint est correctement enregistré dans la configuration Vercel
- Utilise un cache avec TTL pour optimiser les performances
Quand vous devez ajouter une route API serverless à un projet Vercel existant utilisant les conventions NuxChain.
Pour des endpoints simples ne nécessitant pas de cache, CORS ou gestion d'erreurs complexe, ou si le projet n'utilise pas Vercel.
Analyse de sécurité
SûrThe skill only instructs creating API endpoint files using standard Write/Edit tools, with no execution of dangerous commands, no data exfiltration, and no safety bypass. It follows best practices for CORS, error handling, and caching, posing no security risk.
Aucun point d'attention détecté
Comment cette analyse est faiteExemples
Create a new API endpoint for fetching user profile data. Use the namespace 'users' and action 'profile'.Add a new route to /api/products/list that returns a list of products with caching.name: vercel-api-endpoint description: Create a new Vercel serverless API endpoint for NuxChain. Use when user says "create an API", "new endpoint", "add a route to /api/", "serverless function", or needs a backend handler. Enforces the project's pattern: TypeScript, kvCache, rate limiting, CORS, error handling, and vercel.json registration. allowed-tools: Read, Write, Edit, Glob, Grep model: claude-sonnet-4-5 license: MIT metadata: author: nuxchain version: '1.0.0'
See full skill at: .agents/skills/vercel-api-endpoint/SKILL.md
Vercel API Endpoint — Quick Reference
File Location
api/<namespace>/<action>.ts
Checklist (every new endpoint)
- [ ] File at
api/<namespace>/<action>.ts - [ ] Handles OPTIONS (CORS preflight)
- [ ] Uses
kvCachefrom../_services/kv-cache-service - [ ] try/catch with proper error response
- [ ] Registered in
vercel.jsonunder"functions"and"headers" - [ ] Proxy added in
vite.config.ts→ port 3003 - [ ] Local handler added in
src/server/api-server.js
Template
import type { VercelRequest, VercelResponse } from '@vercel/node';
import { kvCache } from '../_services/kv-cache-service';
export default async function handler(req: VercelRequest, res: VercelResponse) {
if (req.method === 'OPTIONS') { res.status(200).end(); return; }
if (req.method !== 'GET') { res.status(405).json({ error: 'Method not allowed' }); return; }
try {
const cached = await kvCache.get('key', { namespace: 'ns', ttl: 30 });
if (cached) return res.json({ success: true, data: cached, cached: true });
const data = await fetchData();
await kvCache.set('key', data, { namespace: 'ns', ttl: 30 });
res.json({ success: true, data, cached: false, timestamp: Date.now() });
} catch (error) {
res.status(500).json({ error: 'Internal server error', message: error instanceof Error ? error.message : 'Unknown' });
}
}
Du fichier au premier essai
Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.
Consulter la source et ses fichiers annexesCe téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.
1. Télécharger le fichier
Télécharger SKILL.mdDepuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/vercel-api-endpoint-mma3jrrz/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.
Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.
mkdir -p '.skill-downloads/vercel-api-endpoint-mma3jrrz' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/vercel-api-endpoint-mma3jrrz/download' --output '.skill-downloads/vercel-api-endpoint-mma3jrrz/SKILL.md.part' && mv '.skill-downloads/vercel-api-endpoint-mma3jrrz/SKILL.md.part' '.skill-downloads/vercel-api-endpoint-mma3jrrz/SKILL.md'2. Vérifier les prérequis
Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.
Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.
Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.
3. Charger la skill
Le fichier ne fournit pas un en-tête name/description exploitable pour cette procédure native. Le téléchargement reste disponible pour lecture ; utilisez le mode manuel ci-dessous.
Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.
4. Faire un premier essai
Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :
Lis .skill-downloads/vercel-api-endpoint-mma3jrrz/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.
Bonnes pratiques React Hook Form
Developpement
Maîtrisez React Hook Form : évitez les anti-patterns, gérez les abonnements, et traitez correctement reset, dirty state et entrées contrôlées.
Migration Emotion vers Mantine
Developpement
Migrer les styled-components Emotion vers des composants Mantine avec style props et modules CSS. Pour convertir .styled.tsx ou supprimer les imports @emotion.
Détecteur de dérive de périmètre
Developpement
Analyse les diffs git par rapport à une intention pour détecter la dérive de périmètre, fichiers non liés et PR trop larges, puis suggère de garder, diviser ou justifier.