atlasmd-icons

Generate AtlasMD logos and favicons from a single source icon image.

Updated Aug 4, 2026
One-click install
npx skills add https://github.com/joaomcarlos/AtlasMD --skill atlasmd-icons-joaomcarlos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: atlasmd-icons
Source: https://github.com/joaomcarlos/AtlasMD/tree/main/ai/skills/atlasmd-icons
Command: npx skills add https://github.com/joaomcarlos/AtlasMD --skill atlasmd-icons-joaomcarlos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pillow, rembg, numpy, and includes scripts (resource) components.

What problem does it solve? Setting up branding for an AtlasMD documentation site requires producing six different image assets (three logo variants, two PNG favicons, and a multi-size ICO file) at specific sizes and with transparent backgrounds. Doing this manually with image editors is repetitive and error-prone, and missing files cause broken favicons or logos in the rendered site. ## Core Features & Use Cases - Complete asset generation: Produces all logos (logo-light-mode.png, logo-dark-mode.png, logo-dark-mode-bg.png) and favicons (favicon.ico with sizes 16-256, favicon-16.png, favicon-32.png) from one source image. - Automatic background removal: Uses rembg with the ISNet model to strip backgrounds, tight-crops to the subject via numpy alpha thresholding, and resizes with Lanczos resampling. - Zero-install execution: Runs via uv run with inline dependency metadata, so Pillow, rembg, and numpy install automatically into an ephemeral environment. - Use Case: You are scaffolding a new AtlasMD consumer project and have a single app icon PNG. Run the script against the project's public/ directory and every required branding asset appears, served by convention with no configuration. ## Quick Start Run the generate-icons script with uv, passing your source icon and the consumer project's public directory, to generate all AtlasMD logos and favicons in one step.

Frequently Asked Questions about atlasmd-icons

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate favicons and logos from one image in Python?

Run the generate-icons script with uv, passing --source for your icon and --public for the target public directory. It produces three logo PNGs, two PNG favicons, and a multi-size favicon.ico using Pillow, rembg, and numpy.

How do I remove the background from an app icon automatically?

The script removes backgrounds by default using rembg with the isnet-general-use model, then tight-crops to the subject using a numpy alpha threshold. If your source already has transparency, pass --no-bg-removal to skip this step.

What image formats does the icon generator support?

Pillow supports PNG, JPG, WebP, BMP, GIF, and TIFF as source images. SVG files require ImageMagick or rsvg-convert since Pillow alone cannot read SVG.

Why is my favicon not updating in the browser after regenerating?

Browsers cache favicons aggressively, so hard-refresh with Cmd+Shift+R or clear the cache. Verify the file is served by checking that a request to /favicon.ico returns HTTP 200.

What dependencies are required to run the icon generation script?

Only uv is required on your system. The script declares Pillow, rembg, and numpy via inline metadata, and uv run installs them automatically into an ephemeral environment with Python 3.10 or later.