Synthèse automatique
Assiste la conception d'API REST ou GraphQL cohérentes, de la modélisation des ressources jusqu'à la spécification OpenAPI 3.0.
Points forts
- Couvre le cycle complet : nommage des ressources, schémas de requête/réponse, erreurs, pagination et filtrage
- Produit une spécification OpenAPI 3.0 exploitable
- Inclut des recommandations sur l'authentification et la limitation de débit
Limites
- Ne valide pas la spécification générée contre un linter ou un outil réel
- Reste générique sur GraphQL : pas de conception détaillée de schémas, resolvers ou subscriptions
- Les choix d'authentification et de rate limiting sont suggérés, pas implémentés
À utiliser lorsqu'on démarre une nouvelle API ou qu'on veut formaliser et documenter des endpoints existants.
À éviter si l'on cherche à générer du code serveur fonctionnel ou à faire un audit de sécurité approfondi d'une API en production.
Analyse de sécurité
SûrThe skill is a purely advisory instruction file for designing REST/GraphQL APIs. It declares no tools, contains no code, no shell commands, no network calls, and no credential or file access. All steps (resource naming, OpenAPI generation, auth strategy suggestions) are documentation-level guidance with no execution risk.
Aucun point d'attention détecté
Comment cette analyse est faiteExemples
Design a REST API for a task management app with projects, tasks and comments. Give me resource URLs, request/response schemas, error formats and an OpenAPI 3.0 spec.Refactor these endpoints to add consistent pagination, filtering and sorting patterns, and update the OpenAPI spec accordingly.Here is my domain model for an e-commerce catalog. Should I expose it as REST or GraphQL, and what would the API surface look like?API Design Assistant
Help design clean, consistent APIs following REST or GraphQL best practices.
When to Use
- Designing a new API from scratch
- Refactoring existing API endpoints
- Need OpenAPI/Swagger documentation
Instructions
- Analyze the domain model and resources
- Suggest RESTful resource naming and URL patterns
- Design request/response schemas
- Generate OpenAPI 3.0 specification
- Add pagination, filtering, and sorting patterns
- Include error response formats
- Suggest authentication and rate limiting strategies
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.
Provenance externe non renseignée : seule la copie de cette fiche est disponible.
Ce 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/api-design-assistant-9321cf/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/api-design-assistant-9321cf' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/api-design-assistant-9321cf/download' --output '.skill-downloads/api-design-assistant-9321cf/SKILL.md.part' && mv '.skill-downloads/api-design-assistant-9321cf/SKILL.md.part' '.skill-downloads/api-design-assistant-9321cf/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/api-design-assistant-9321cf/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.