agentleFS
krowtenkrowten/claude-media-generation/skills/generate-svg/SKILL.md

generate-svg

Skill5 starsChanged 8 days agoMITView on GitHub

Generate true SVG vector graphics from a text prompt (Recraft V4.1) or convert an existing raster image to SVG (Recraft vectorize) via fal.ai — logos, icons, flat illustrations, brand marks, favicons, spot art that must stay sharp at any size. Use whenever the user asks for an SVG, a vector version of an image, a scalable logo/icon, or artwork destined for Figma/Illustrator — even if they don't say "fal.ai" or name a model. Prefer it over hand-writing SVG markup for anything that should look designed (a logo, brand mark, illustration); hand-write only simple geometric shapes, UI icons or diagrams the user wants as editable code. For raster images (photos, hero shots) use generate-image instead.

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Run it with Bash, e.g.:

    line 13
  2. Very specific:

    If the shell says bun isn't found, Bun isn't installed.

    line 19

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

generate-svg

Wraps fal.ai's Recraft vector endpoints behind one CLI: ${CLAUDE_SKILL_DIR}/scripts/generate-svg.ts. Requires a fal.ai key in FAL_KEY (same key as the other generation skills) — if it's missing the script exits with a clear error, ask the user to export it in their shell — never ask them to paste the key into the chat.

Run it with Bash, e.g.:

bun ${CLAUDE_SKILL_DIR}/scripts/generate-svg.ts generate --prompt "..." --output ./logo.svg

If the shell says bun isn't found, Bun isn't installed. Stop and ask the user to install it from https://bun.com/docs/installation and restart Claude Code. Don't replace the script with other tools or code of your own: the checks it runs before a paid call and on the result would be lost.

Output is a real SVG with editable paths and layers (not a raster in an .svg wrapper) — it drops straight into HTML via <img>/inline <svg>, and into Figma or Illustrator for hand-editing.

generate — text to SVG

generate-svg.ts generate --prompt "<description>" --output <path>.svg
  [--model standard|pro] [--size square_hd|square|portrait_4_3|portrait_16_9|landscape_4_3|landscape_16_9]
  [--width N --height N] [--colors "#RRGGBB,#RRGGBB,..."] [--background "#RRGGBB"]
ModelCostBest for
standard (default, Recraft V4.1)$0.08/imagelogos, icons, flat illustrations, favicons — nearly everything
pro (Recraft V4.1 Pro)$0.30/imagelarge-format poster art, complex multi-object scenes with fine detail

--colors pins the palette to brand colors and --background sets the backdrop — pass the site's actual hex values instead of describing colors in the prompt; it's far more reliable. --width/ --height take exact pixel values as the design size (the SVG itself scales freely).

Prompt for flat, graphic subject matter: "minimal line icon of…", "flat geometric illustration of…", "logo mark, two colors". Photorealism prompts produce a bad fit for vector output — that's generate-image territory.

vectorize — raster image to SVG ($0.01/image)

generate-svg.ts vectorize (--source <path> | --image-url <url>) --output <path>.svg

Converts an existing PNG/JPEG/WebP to SVG paths. Use it to make a raster logo scalable, or to turn a generate-image generation into editable vector art (generate flat artwork cheaply with gpt-image-2.5 --quality low, then vectorize for $0.01 — a useful combo when generate above doesn't nail the composition).

Only vectorize flat/graphic content. Photos and smooth gradients trace into megabyte-scale SVGs that are worse than the original raster in every way — verified: a 100KB gradient PNG came back as a 1.5MB SVG. If the source is photographic, keep it raster.

Input limits (handled automatically for --source): vectorize wants each side over 256px and under 4096px, under 16MP and under 5MB. Oversized sources are downscaled/re-encoded locally before upload, and the final file is checked — a very wide banner that would drop under 256px on its short side after downscaling is rejected with an explanation (crop it first), as are sources that are simply too small, since upscaling adds no detail. Pass exactly one of --source or --image-url.

The script checks that the download really is an SVG. If it contains scripts, event handlers or external links it is not saved and the command fails — generate again with a different prompt.

To look at the result, or to make a PNG, favicon or social image from it, use the process-image skill: it renders .svg sources (process-image.ts resize --source logo.svg --output logo.png --width 512).

generate output carries a C2PA provenance manifest in its <metadata> element (it marks the file as AI-generated) that can be two thirds of a small logo's bytes. Keep it by default; when the user wants the SVG inlined or as small as possible, removing that <metadata> element doesn't change the picture.

A paid result is never lost. As soon as fal.ai accepts a job the script prints its request ID and a ready resume --model … --request-id … --output … command on stderr. If the download fails or the run is interrupted, run that command — it fetches the already-paid result. Don't rerun the original command: that generates (and bills) again.

Cost awareness

Flat per-image pricing, billed to the user's fal.ai key: generate $0.08 (--model pro $0.30), vectorize $0.01. Before a batch (several icons, logo variations), state the total estimate. For a matching icon set, generate them in one style family: same prompt skeleton, same --colors.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.