Come usare
- Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
- Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
- Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/upbrew-tech/svg-creator-skill --skill svg-creatorPrima di iniziare
- L’installazione non include abbonamenti, quote API o accesso ai file.
- Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.
SVG Creator Skill
THE MANDATORY WORKFLOW
Every SVG goes through the feedback loop script. No exceptions. You cannot deliver an SVG you haven't rendered and visually verified.
The Loop
WRITE SVG → RENDER → VIEW PNG → ASSESS → FIX → RENDER → VIEW → ... → DELIVERStep-by-Step
1. Write SVG to a working file:
cat > /home/claude/draft.svg << 'SVGEOF'
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 600">
...
</svg>
SVGEOF2. Render it (MANDATORY — the script tracks this):
python3 /path/to/skill/scripts/svg_loop.py render /home/claude/draft.svgThis creates /home/claude/svg_preview.png.
3. View the rendered PNG (MANDATORY — you must actually look): Use the view tool on /home/claude/svg_preview.png. Study what you see.
4. Assess the result. Ask yourself:
- Are elements positioned correctly?
- Any gaps, overlaps, or misalignment?
- Do proportions look right?
- Are colors and gradients working?
- For characters: are body parts connected naturally?
5. If anything is wrong, fix the SVG and go back to step 2. Edit /home/claude/draft.svg with str_replace or rewrite, then render and view again.
6. When it looks good, deliver:
python3 /path/to/skill/scripts/svg_loop.py finish /home/claude/draft.svg output-name.svgThis copies the SVG + preview PNG to /mnt/user-data/outputs/. The script REFUSES to deliver if you never rendered.
Then use present_files to share the output SVG with the user.
Iteration Guidelines
- Simple icons, logos, patterns: 1-2 iterations usually enough
- Diagrams, infographics: 2-3 iterations
- Scenes, illustrations: 3-5 iterations
- Characters, figures, animals: 5-8 iterations (build incrementally — torso first, then limbs one at a time, rendering after each addition)
Script Commands Reference
python3 scripts/svg_loop.py render <file.svg> # Render + view cycle
python3 scripts/svg_loop.py finish <file.svg> [name.svg] # Deliver (blocks if no render)
python3 scripts/svg_loop.py status # Check iteration count
python3 scripts/svg_loop.py reset # Start freshVISUAL QUALITY TECHNIQUES
Apply these while building the SVG. They work for all SVG types.
Multi-Stop Gradients (4+ Stops)
Two-stop gradients look flat. Use 4-8 stops with hue shifts:
<linearGradient id="sky" x1="0" y1="0" x2="0" y2="1" color-interpolation="linearRGB">
<stop offset="0%" stop-color="#0f172a"/>
<stop offset="25%" stop-color="#1e3a5f"/>
<stop offset="50%" stop-color="#3b82f6"/>
<stop offset="75%" stop-color="#93c5fd"/>
<stop offset="90%" stop-color="#fde68a"/>
<stop offset="100%" stop-color="#f97316"/>
</linearGradient>For spheres: use radial gradient with fx="0.3" fy="0.3" (offset toward light source).
Five-Zone Lighting
Every non-trivial object needs: specular highlight (bright, warm), light area, half-tone (true color), form shadow (cooler hue — blue/purple, NEVER black), reflected light (subtle warm glow on shadow edge, opacity 0.10-0.20).
Colored Shadows
Shadows use dark blue (#1a1a4e), purple (#2d1b4e), or teal (#0d3b4f). Never pure black or gray.
Drop Shadow Filter
<filter id="shadow" x="-20%" y="-20%" width="140%" height="140%"
color-interpolation-filters="linearRGB">
<feGaussianBlur in="SourceAlpha" stdDeviation="4" result="blur"/>
<feOffset in="blur" dx="3" dy="5" result="offset"/>
<feFlood flood-color="#1e1b4b" flood-opacity="0.30" result="color"/>
<feComposite in="color" in2="offset" operator="in" result="shadow"/>
<feMerge><feMergeNode in="shadow"/><feMergeNode in="SourceGraphic"/></feMerge>
</filter>Noise Texture (Breaks Digital Perfection)
<filter id="grain" color-interpolation-filters="linearRGB">
<feTurbulence type="fractalNoise" baseFrequency="0.7" numOctaves="3" stitchTiles="stitch"/>
<feColorMatrix type="saturate" values="0"/>
<feBlend in="SourceGraphic" mode="soft-light"/>
</filter>Apply at 5-15% opacity on surfaces and backgrounds.
Critical Defaults
- All
<filter>elements:color-interpolation-filters="linearRGB" - All gradient elements:
color-interpolation="linearRGB" - Animated elements:
transform-box: fill-box; transform-origin: center;
CATEGORY-SPECIFIC GUIDANCE
Characters, Figures, Animals
The hardest category. Build incrementally with aggressive feedback:
- Draw torso → render → verify
- Add legs → render → verify connection
- Add arms → render → verify
- Add head → render → verify
- Add details → render → final check
Use thick <line> with stroke-linecap="round" for limbs. Add <circle> at every joint drawn AFTER the limbs. This gives the most reliable connected look.
For animated characters: use React/JSX artifacts with forward kinematics (JS computes positions from joint angles — guarantees connected joints).
Icons (24×24 stroke-based)
Grid-aligned, 2px stroke, stroke-linecap="round", stroke-linejoin="round", fill="none", stroke="currentColor". Stay within 2-22 coordinate range. Usually one-pass works.
Logos and Badges
Geometric construction, centered. Gradient fills for depth. Max 2-3 colors. Test legibility at small size (render at 64px width).
Scenes and Landscapes
Layer back-to-front: sky → far elements (desaturated, light) → mid elements → foreground (vivid). Add atmospheric haze (semi-transparent blue-white rect) between layers. Vignette overlay last.
Data Visualizations
Compute positions from data. Use gradient fills on bars/segments. Subtle grid lines (#f1f5f9). Round caps everywhere.
Patterns
Small repeating tiles. Use <pattern> element with patternUnits="userSpaceOnUse". patternTransform="rotate(45)" for diagonal variants.
DOCUMENT STRUCTURE
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 600"
role="img" aria-labelledby="svg-title">
<title id="svg-title">Descriptive Title</title>
<defs><!-- gradients, filters, clipPaths --></defs>
<g id="background">...</g>
<g id="midground">...</g>
<g id="foreground">...</g>
<g id="effects">...</g>
</svg>ADVANCED REFERENCE
Read references/advanced-techniques.md for complete recipes: filter chains, feTurbulence guide, feComponentTransfer color grading, material simulation, composition templates, atmospheric effects, animation (CSS + SMIL), and more.