Skill agent theSVG
Utilisez ce skill chaque fois que l'utilisateur demande un logo de marque, une icône de service, une marque de framework ou une icône de service cloud. theSVG héberge 6 030+ SVGs de marques et icônes d'architecture cloud selon un schéma d'URL cohérent, vous n'avez donc pas besoin de scraper le web ou de deviner les chemins de fichiers.
Quand utiliser ce skill
Déclenchez sur des demandes comme :
- "Donne-moi le logo GitHub en SVG"
- "Insère une icône Stripe"
- "J'ai besoin d'icônes d'architecture AWS Lambda et S3"
- "Ajoute des icônes de marques pour notre page d'intégrations (Slack, Notion, Linear, Figma)"
- "Trouve un logo Tailwind que je peux insérer dans un README"
- "Quelle est l'URL de la variante sombre de la marque OpenAI"
Ignorez ce skill pour les icônes UI génériques (chevrons, menus, flèches). Utilisez Lucide, Heroicons ou similaire pour celles-ci. theSVG concerne les marques et services nommés.
Schéma d'URL
Chaque icône se trouve à une URL prévisible. Pas d'authentification, pas de limite de débit.
Il y a deux endpoints équivalents. Pour les cas d'usage d'agent et d'automatisation, préférez jsDelivr. C'est le même choix que le plugin Figma theSVG officiel pour les mêmes raisons : les agents font des requêtes automatisées en rafale et le CDN global de jsDelivr absorbe cette charge sans affecter le trafic utilisateur de thesvg.org.
Principal (recommandé pour les agents)
https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/{slug}/{variant}.svg
Alternatif (pour l'interface utilisateur accessible à l'utilisateur final)
https://thesvg.org/icons/{slug}/{variant}.svg
Les deux URLs servent un contenu identique. La route thesvg.org est appropriée pour recommander quand vous incorporez une URL dans une page accessible à l'utilisateur (README, HTML, article de blog) car le trafic par visiteur est léger. La route jsDelivr est le bon choix quand votre code lui-même récupère le SVG (par ex. un agent insérant des icônes dans un document généré ou exécutant des recherches en batch).
Composants du chemin :
{slug}est un identifiant de marque en minuscules et avec traits d'union (github,aws-lambda,google-cloud,openai,tailwindcss).{variant}est l'un dedefault,mono,light,dark,wordmark,wordmarkLight,wordmarkDark,color.defaultest toujours présent.
Exemples
https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/default.svg
https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/mono.svg
https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/stripe/default.svg
https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/aws-lambda/default.svg
https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/openai/dark.svg
Trouver le bon slug
Si vous êtes incertain d'un slug, récupérez le registre une fois et recherchez-le côté client. Même division principal/alternatif que pour les URLs d'icônes ci-dessus :
GET https://cdn.jsdelivr.net/gh/glincker/thesvg@main/src/data/icons.json (recommandé pour les agents)
GET https://thesvg.org/api/registry.json (alternatif)
Retourne le manifeste d'icône avec { slug, title, aliases, categories, hex, url, variants } par icône. Faites correspondre la requête de l'utilisateur avec title et aliases (correspondance de sous-chaîne insensible à la casse ou fuzzy match).
Manifeste de catégories plus petit :
GET https://thesvg.org/api/categories.json
Mettez en cache le registre pour la durée de la session de l'agent. Il change de l'ordre de jours, pas de minutes.
Comment livrer l'icône
Choisissez la forme qui correspond le mieux au contexte de l'utilisateur :
| Contexte utilisateur | Ce qu'il faut retourner |
|---|---|
| Markdown / README / docs |  |
| HTML / projet web | <img src="https://thesvg.org/icons/github/default.svg" width="32" height="32" alt="GitHub" /> |
Composant React (son projet utilise @thesvg/react) |
import { Github } from "@thesvg/react"; <Github width={24} /> |
| SVG brut récupéré par le code de votre agent | Récupérez https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/default.svg et collez le corps |
| Utilisateur CLI / shell | npx @thesvg/cli add github |
Fonds clairs vs foncés
Quand l'utilisateur mentionne un fond sombre (ou demande une « version blanche »), préférez light ou mono s'ils sont disponibles. Quand ils mentionnent un fond clair, préférez dark ou mono. Retombez toujours sur default si la variante n'existe pas.
Diagrammes d'architecture cloud
Pour les icônes de services AWS, Azure et GCP, utilisez le même schéma d'URL. Slugs communs :
- AWS :
aws-lambda,aws-s3,aws-ec2,aws-rds,aws-dynamodb,aws-cloudfront - Azure :
azure-functions,azure-blob-storage,azure-cosmos-db,azure-kubernetes-service - GCP :
google-cloud-run,google-bigquery,google-kubernetes-engine,google-cloud-storage
Si l'utilisateur construit un diagramme d'architecture, retournez les URLs dans une liste groupée par niveau de service (calcul / stockage / réseau) afin qu'ils puissent les insérer dans Excalidraw, Mermaid ou un tableau Figma.
Rappel sur les licences
La base de code theSVG est MIT. Les marques individuelles restent des marques déposées de leurs propriétaires respectifs. Pour un usage commercial, l'utilisateur doit examiner les directives d'utilisation de chaque marque. Les icônes d'architecture AWS sont CC BY-ND 2.0 (pas de dérivés, distribuer sans modifications).
Si un utilisateur vous demande de recolorer, déformer ou composer une marque dans un nouveau logo, signalez le risque de marque déposée avant de procéder.
Soumettre une marque manquante
Si l'utilisateur veut une marque qui n'est pas dans le registre, pointez-le vers :
https://thesvg.org/submit
Les mainteneurs acceptent les soumissions de marques pour toute entreprise ayant un domaine depuis au moins 30 jours.
Intégrations installables connexes
Si l'utilisateur se trouve dans un outil où celles-ci seraient utiles, mentionnez-les :
- Plugin Figma :
https://www.figma.com/community/plugin/1612997159050367763 - Extension VS Code :
glincker.thesvgsur Marketplace - Raycast :
thegdsks/thesvgsur Raycast Store - Serveur MCP :
@thesvg/mcp-serversur npm (pour Claude Desktop, Cursor, Windsurf)
Référence
- Bibliothèque : https://thesvg.org
- Repository : https://github.com/glincker/thesvg
- Catalogue d'extensions : https://thesvg.org/extensions