Extract project logo

This skill extracts a project's official logo from its website or related sources, prioritising high-quality vector formats and official brand assets.

Required inputs

Before starting, gather the following from the user:

Website URL - The project's main website (e.g.,
```
https://example.com
```
)
Save path - Local filesystem path where the logo should be saved (e.g.,
```
./logos/example-logo.svg
```
)
Format preference (optional) - Preferred format: SVG (recommended), PNG, or any

If any required input is missing, ask the user before proceeding.

Save all project logos in the target folder. We will pick variants and post-process those later.

There is no universal standard how artist name their logo files for dark and light variants. In our case, we always say

```
light
```
: light (white) text on dark or transparent background
```
dark
```
: dark (black) text on white or transparent background

Following vocabulary is used:

Brand mark: same as logo mark, the logo without the brand name text
Word mark: the logo with the brand name text

Step 1: Search for brand kit or media resources

The highest quality logos are typically found in official brand/media kits. Search for these pages:

Navigate to the website and look for links in the footer or header:
- "Brand", "Brand Kit", "Brand Assets", "Brand Guidelines"
- "Media", "Media Kit", "Press", "Press Kit"
- "Resources", "Downloads", "Assets"

Try common URL patterns:

```
{base_url}/brand
```
```
{base_url}/brand-kit
```
```
{base_url}/media
```
```
{base_url}/press
```
```
{base_url}/assets
```
```
{base_url}/resources
```

If a brand kit is found:
- Look for downloadable logo packages (often ZIP files)
- Prefer SVG or vector formats over raster images
- Choose the most square logo variant if multiple options exist
- If both light and dark themes are present, get both
- If colourful option exist, get it as well

If a brand kit is found with suitable logos, proceed to Step 5.

Step 2: Check GitHub repository

Many projects host their logos in their GitHub repositories:

Find the project's GitHub repository (often linked in website footer/header)
Search these common locations:
- ```
/assets/
```
  or
```
/images/
```
  directories
- ```
/branding/
```
  or
```
/brand/
```
  directories
- ```
/public/
```
  directory (for web apps)
- ```
/docs/
```
  or
```
/documentation/
```
  directories
- Root directory (README badges, logo files)
Check the README.md for embedded logos:
- Look for
```
<img>
```
  tags or markdown image syntax
- These often point to high-quality logo files

Search for files named:

```
logo.svg
```
,
```
logo.png
```
,
```
logo-*.svg
```
```
{project-name}.svg
```
,
```
{project-name}-logo.*
```
```
brand.*
```
,
```
icon.*
```

If a suitable logo is found, proceed to Step 4.

Step 3: Extract from website directly

If no brand kit or GitHub assets are available, extract the logo from the website:

Option A: Using MCP Playwright (recommended for dynamic sites)

Use the MCP Playwright tool to:

Navigate to the homepage
Look for logo elements in the header (typically top-left):
- Search for
```
<img>
```
  tags with class/id containing "logo"
- Check for
```
<svg>
```
  elements in the header
- Look for elements with
```
role="img"
```
  and logo-related aria labels
Extract the image source URL or SVG content

Option B: Check meta tags and favicon

Open Graph image - Check for
```
<meta property="og:image">
```
tag
- Often a high-quality image suitable for social sharing
- May include branding elements
Favicon - Check for high-resolution favicon:
- ```
<link rel="icon" type="image/svg+xml">
```
  (best - vector)
- ```
<link rel="apple-touch-icon">
```
  (usually 180x180 PNG)
- ```
/favicon.ico
```
  (low resolution, last resort)
Twitter Card image - Check
```
<meta name="twitter:image">
```

Step 4: Extract from Twitter

Get the project logo from their Twitter (also known as X.com) avatar image.

Step 5: Extract from Coingecko

Get the project logo from their Coingecko.

Step 6: Download and save

For SVG files:
- Download the raw SVG content
- Ensure the file is valid XML
- Save with
```
.svg
```
  extension
For raster images (PNG, etc.):
- Download the highest resolution available
- Verify file integrity after download
- Save with appropriate extension
Verify the saved file:
- Open the file to confirm it displays correctly
- Check file size is reasonable (not 0 bytes or corrupted)

Download methods

Using curl:

shell

curl -o "{save_path}" "{logo_url}"

Using Python:

python

import requests

response = requests.get("{logo_url}")
with open("{save_path}", "wb") as f:
    f.write(response.content)

For SVG content extracted directly:

python

with open("{save_path}", "w") as f:
    f.write(svg_content)

Step 7: Report results to user

Provide the user with:

Source location - Where the logo was found (brand kit URL, GitHub path, etc.)
File details - Format, dimensions (for raster), file size
Saved path - Confirm where the file was saved
Alternative versions - Note if other variants are available (dark mode, icon-only, etc.)

Step 8: Save the report as Markdown file next to the logos

Create a Markdown file in the folder where logos where saved
Include the same information as for the user report
Include links to the web pages, brand pages and brand kits used

Troubleshooting

No logo found

If no suitable logo can be found:

Check if the project uses a different primary domain
Look for the project on social media (Twitter/X, LinkedIn) - profile images are often logos
Search "[project name] logo" on image search engines
Check DeFiLlama, CoinGecko, or similar aggregators for crypto projects
Ask the user if they have alternative sources or contacts

Dynamic/JavaScript-rendered logos

If the logo is rendered via JavaScript:

Use MCP Playwright to load the page fully
Wait for dynamic content to render
Extract from the rendered DOM

Logo requires authentication

If brand assets are behind a login:

Inform the user
Provide the URL to the brand kit page
Ask the user to download manually or provide credentials (if appropriate)

extract-project-logo

NPX Install

Tags

SKILL.md Content