# thesvg

Adopt this skill: https://proskills.md/skills/other/glincker-thesvg-skills-thesvg

Page: https://proskills.md/skills/other/glincker-thesvg-skills-thesvg
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/thesvg/SKILL.md
size: 6300
sha: 45e22de65b73695e460e0e9ef3e113b9d8b084d2
upstream: https://github.com/glincker/thesvg/blob/main/skills/thesvg/SKILL.md

````text
---
name: thesvg
description: Fetch brand SVG logos and cloud architecture icons (AWS, Azure, GCP) from theSVG. Use when the user asks for a brand logo, company icon, framework mark, service icon, or any "icon/logo for X" where X is a real brand or cloud service. Returns ready-to-use CDN URLs or raw SVG markup.
license: MIT
---

# theSVG agent skill

Use this skill whenever the user asks for a brand logo, service icon, framework mark, or cloud service icon. theSVG hosts 7,600+ brand SVGs and cloud architecture icons under one consistent URL pattern, so you do not need to scrape the web or guess at file paths.

## When to use this skill

Trigger on requests like:

- "Give me the GitHub logo as SVG"
- "Insert a Stripe icon"
- "I need AWS Lambda and S3 architecture icons"
- "Add brand icons for our integrations page (Slack, Notion, Linear, Figma)"
- "Find a Tailwind logo I can drop into a README"
- "What's the URL for the dark variant of the OpenAI mark"

Skip this skill for generic UI icons (chevrons, menus, arrows). theSVG ships its own UI icon set for those (`@thesvg/ui-react` and siblings). theSVG brand icons are for **named brands and services**.

## URL pattern

Every icon lives at a predictable URL. No auth, no rate limits.

There are two equivalent endpoints. **For agent and automation use cases, prefer jsDelivr.** It is the same choice the official thesvg Figma plugin makes for the same reasons: agents make bursty automated requests and jsDelivr's global CDN absorbs that load without affecting thesvg.org user traffic.

### Primary (recommended for agents)

```
https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/{slug}/{variant}.svg
```

### Alternate (for end-user-facing UI)

```
https://thesvg.org/icons/{slug}/{variant}.svg
```

Both URLs serve identical content. The thesvg.org route is fine to recommend when you're embedding a URL into a user-facing page (README, HTML, blog post) because per-visitor traffic is light. The jsDelivr route is the right choice when your code itself fetches the SVG (e.g. an agent inserting icons into a generated document or running batch lookups).

Path components:

- `{slug}` is a lowercase, hyphenated brand identifier (`github`, `aws-lambda`, `google-cloud`, `openai`, `tailwindcss`).
- `{variant}` is one of `default`, `mono`, `light`, `dark`, `wordmark`, `wordmarkLight`, `wordmarkDark`, `color`. `default` is always present.

### Examples

```
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
```

## Finding the right slug

If you're unsure of a slug, fetch the registry once and search it client-side. Same primary/alternate split as the icon URLs above:

```
GET https://cdn.jsdelivr.net/gh/glincker/thesvg@main/src/data/icons.json   (recommended for agents)
GET https://thesvg.org/api/registry.json                                   (alternate)
```

Returns the icon manifest with `{ slug, title, aliases, categories, hex, url, variants }` per icon. Match the user's query against `title` and `aliases` (case-insensitive substring or fuzzy match).

Smaller categories manifest:

```
GET https://thesvg.org/api/categories.json
```

Cache the registry for the duration of the agent session. It changes on the order of days, not minutes.

## How to deliver the icon

Pick the form that best matches the user's context:

| User context | What to return |
|---|---|
| Markdown / README / docs | `![GitHub](https://thesvg.org/icons/github/default.svg)` |
| HTML / web project | `<img src="https://thesvg.org/icons/github/default.svg" width="32" height="32" alt="GitHub" />` |
| React component (their project uses `@thesvg/react`) | `import { Github } from "@thesvg/react"; <Github width={24} />` |
| Raw SVG fetched by your agent code | Fetch `https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/default.svg` and paste the body |
| CLI / shell user | `npx @thesvg/cli add github` |

## Light vs dark backgrounds

When the user mentions a dark background (or asks for a "white version"), prefer `dark` (the variant for dark backgrounds, light fill) or `mono` if available. When they mention a light background, prefer `light` (dark fill) or `mono`. Always fall back to `default` if the variant doesn't exist.

## Cloud architecture diagrams

For AWS, Azure, and GCP service icons, use the same URL pattern. Common slugs:

- 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`

If the user is building an architecture diagram, return URLs in a list grouped by service tier (compute / storage / network) so they can drop them into Excalidraw, Mermaid, or a Figma board.

## Licensing reminder

theSVG codebase is MIT. Individual brand marks remain trademarks of their respective owners. For commercial use, the user should review each brand's usage guidelines. AWS Architecture Icons are CC BY-ND 2.0 (no derivatives, distribute unmodified).

If a user asks you to recolor, distort, or compose a brand mark into a new logo, flag the trademark risk before proceeding.

## Submitting a missing brand

If the user wants a brand that isn't in the registry, point them at:

```
https://thesvg.org/submit
```

The maintainers accept brand submissions for any company with a domain at least 30 days old.

## Related installable integrations

If the user is in a tool where these would help, mention them:

- **Figma plugin**: `https://www.figma.com/community/plugin/1612997159050367763`
- **VS Code extension**: `glincker.thesvg` on Marketplace
- **Raycast**: `thegdsks/thesvg` on Raycast Store
- **MCP server**: `@thesvg/mcp-server` on npm (for Claude Desktop, Cursor, Windsurf)

## Reference

- Library: https://thesvg.org
- Repository: https://github.com/glincker/thesvg
- Extensions catalog: https://thesvg.org/extensions
````

## File: README.md
upstream: https://github.com/glincker/thesvg/blob/main/README.md

```text
<p align="center">
  <a href="https://thesvg.org">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/glincker/thesvg/main/public/logo-wordmark-dark.svg" />
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/glincker/thesvg/main/public/logo-wordmark.svg" />
      <img src="https://raw.githubusercontent.com/glincker/thesvg/main/public/logo-wordmark.svg" alt="theSVG" height="48" />
    </picture>
  </a>
</p>

<h3 align="center">The open SVG brand library</h3>

<p align="center"><b>A HOME FOR EVERY BRAND.</b></p>

<p align="center">
  7,600+ brand logos and cloud icons. Search, copy and ship them as SVG, React, Vue, Svelte, CDN, CLI or MCP.<br />
  Free, open source, no gatekeeping.
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/thesvg"><img src="https://img.shields.io/npm/v/thesvg?style=flat-square&color=C2410C&label=npm" alt="npm" /></a>
  <a href="https://www.npmjs.com/package/thesvg"><img src="https://img.shields.io/npm/dm/thesvg?style=flat-square&color=C2410C&label=downloads" alt="downloads" /></a>
  <a href="https://www.npmjs.com/package/@thesvg/mcp-server"><img src="https://img.shields.io/npm/v/@thesvg/mcp-server?style=flat-square&color=C2410C&label=MCP" alt="MCP server" /></a>
  <a href="https://www.jsdelivr.com/package/gh/glincker/thesvg"><img src="https://data.jsdelivr.com/v1/package/gh/glincker/thesvg/badge" alt="jsDelivr" /></a>
  <a href="https://github.com/glincker/thesvg/stargazers"><img src="https://img.shields.io/github/stars/glincker/thesvg?style=flat-square&label=stars" alt="stars" /></a>
  <a href="https://discord.gg/Ar5pcaZB99"><img src="https://img.shields.io/discord/829168897080557579?style=flat-square&logo=discord&logoColor=white&label=discord&color=5865F2" alt="Discord" /></a>
  <a href="https://github.com/glincker/thesvg"><img src="https://img.shields.io/badge/icons-7%2C600%2B-C2410C?style=flat-square" alt="7,600+ icons" /></a>
  <a href="https://github.com/glincker/thesvg/blob/main/LICENSE"><img src="https://img.shields.io/github/license/glincker/thesvg?style=flat-square" alt="license" /></a>
  <a href="https://www.figma.com/community/plugin/1612997159050367763"><img src="https://img.shields.io/badge/Figma-Plugin-F24E1E?style=flat-square&logo=figma&logoColor=white" alt="Figma" /></a>
  <a href="https://marketplace.visualstudio.com/items?itemName=glincker.thesvg"><img src="https://img.shields.io/badge/VS%20Code-Extension-007ACC?style=flat-square&logo=visualstudiocode&logoColor=white" alt="VS Code" /></a>
  <a href="https://www.raycast.com/thegdsks/thesvg"><img src="https://img.shields.io/badge/Raycast-Store-FF6363?style=flat-square&logo=raycast" alt="Raycast" /></a>
  <a href="https://icon-sets.iconify.design/thesvg-color/"><img src="https://img.shields.io/badge/Iconify-2%20sets-026C9C?style=flat-square" alt="Iconify" /></a>
  <a href="https://github.com/glincker/thesvg/tree/main/extensions/neovim"><img src="https://img.shields.io/badge/Neovim-Plugin-019733?style=flat-square&logo=neovim&logoColor=white" alt="Neovim" /></a>
  <a href="https://github.com/glincker/thesvg/tree/main/extensions/alfred"><img src="https://img.shields.io/badge/Alfred-Workflow-5C1F87?style=flat-square&logo=alfred&logoColor=white" alt="Alfred" /></a>
  <a href="https://github.com/glincker/thesvg/tree/main/extensions/browser"><img src="https://img.shields.io/badge/Chrome-Coming%20Soon-4285F4?style=flat-square&logo=googlechrome&logoColor=white" alt="Chrome" /></a>
  <a href="https://skills.sh/glincker/thesvg"><img src="https://skills.sh/b/glincker/thesvg" alt="skills.sh" /></a>
  <a href="https://github.com/glincker/homebrew-thesvg"><img src="https://img.shields.io/badge/Homebrew-thesvg-FBB040?style=flat-square&logo=homebrew&logoColor=white" alt="Homebrew" /></a>
  <a href="https://socket.dev/npm/package/@thesvg/icons"><img src="https://socket.dev/api/badge/npm/package/@thesvg/icons" alt="Socket score for @thesvg/icons" /></a>
  <a href="https://socket.dev/npm/package/thesvg"><img src="https://socket.dev/api/badge/npm/package/thesvg" alt="Socket score for thesvg" /></a>
  <a href="https://www.npmjs.com/package/@thesvg/icons"><img src="https://img.shields.io/badge/provenance-verified-2EA44F?style=flat-square" alt="npm provenance verified" /></a>
</p>

<p align="center">
  <a href="https://thesvg.org"><strong>Browse icons</strong></a> &nbsp;&bull;&nbsp;
  <a href="#quick-start">Quick start</a> &nbsp;&bull;&nbsp;
  <a href="#install">Install</a> &nbsp;&bull;&nbsp;
  <a href="#extensions">Extensions</a> &nbsp;&bull;&nbsp;
  <a href="#cdn">CDN</a> &nbsp;&bull;&nbsp;
  <a href="#api">API</a> &nbsp;&bull;&nbsp;
  <a href="#packages">Packages</a> &nbsp;&bull;&nbsp;
  <a href="https://thesvg.org/compare">Compare</a> &nbsp;&bull;&nbsp;
  <a href="#community">Community</a> &nbsp;&bull;&nbsp;
  <a href="#contributing">Contribute</a> &nbsp;&bull;&nbsp;
  <a href="#contributors">Contributors</a>
</p>

<p align="center">
  <a href="https://thesvg.org">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/glincker/thesvg/main/public/og-image.png" />
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/glincker/thesvg/main/public/og-image-light.png" />
      <img src="https://raw.githubusercontent.com/glincker/thesvg/main/public/og-image-light.png" alt="theSVG, the open SVG brand library" width="720" />
    </picture>
  </a>
</p>

<p align="center">
  <sub>Every logo below is served straight from theSVG.</sub>
</p>

<p align="center">
  <a href="https://thesvg.org/icon/google"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/google/default.svg" height="34" alt="Google" /></a>&nbsp;&nbsp;&nbsp;
  <a href="https://thesvg.org/icon/docker"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/docker/default.svg" height="34" alt="Docker" /></a>&nbsp;&nbsp;&nbsp;
  <a href="https://thesvg.org/icon/kubernetes"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/kubernetes/default.svg" height="34" alt="Kubernetes" /></a>&nbsp;&nbsp;&nbsp;
  <a href="https://thesvg.org/icon/react"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/react/default.svg" height="34" alt="React" /></a>&nbsp;&nbsp;&nbsp;
  <a href="https://thesvg.org/icon/vue"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/vue/default.svg" height="34" alt="Vue" /></a>&nbsp;&nbsp;&nbsp;
  <a href="https://thesvg.org/icon/svelte"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/svelte/default.svg" height="34" alt="Svelte" /></a>&nbsp;&nbsp;&nbsp;
  <a href="https://thesvg.org/icon/typescript"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/typescript/default.svg" height="34" alt="TypeScript" /></a>&nbsp;&nbsp;&nbsp;
  <a href="https://thesvg.org/icon/tailwindcss"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/tailwindcss/default.svg" height="34" alt="Tailwind CSS" /></a>&nbsp;&nbsp;&nbsp;
  <a href="https://thesvg.org/icon/figma"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/figma/default.svg" height="34" alt="Figma" /></a>&nbsp;&nbsp;&nbsp;
  <a href="https://thesvg.org/icon/stripe"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/stripe/default.svg" height="34" alt="Stripe" /></a>
</p>

<p align="center">
  <a href="https://thesvg.org/icon/slack"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/slack/default.svg" height="34" alt="Slack" /></a>&nbsp;&nbsp;&nbsp;
  <a href="https://thesvg.org/icon/discord"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/discord/default.svg" height="34" alt="Discord" /></a>&nbsp;&nbsp;&nbsp;
  <a href="https://thesvg.org/icon/spotify"><img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/spoti
```
