thesvg

Par glincker · thesvg

Récupère les logos SVG de marques et les icônes d'architecture cloud (AWS, Azure, GCP) depuis theSVG. À utiliser lorsque l'utilisateur demande un logo de marque, une icône d'entreprise, un logo de framework, une icône de service, ou tout « icône/logo pour X » où X est une vraie marque ou un service cloud. Retourne des URLs CDN prêtes à l'emploi ou du markup SVG brut.

npx skills add https://github.com/glincker/thesvg --skill thesvg

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 de default, mono, light, dark, wordmark, wordmarkLight, wordmarkDark, color. default est 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 ![GitHub](https://thesvg.org/icons/github/default.svg)
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.thesvg sur Marketplace
  • Raycast : thegdsks/thesvg sur Raycast Store
  • Serveur MCP : @thesvg/mcp-server sur npm (pour Claude Desktop, Cursor, Windsurf)

Référence

Skills similaires