# Svg Collisions

> Create or repair SVG diagrams without overlapping text/shapes. Use when shipping new SVGs, editing WLILO-styled diagrams, or when collision checks report overlaps/clipping.

- Skill: `majiayu000/svg-collisions` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/svg-collisions`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/svg-collisions/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/svg-collisions

---


# SVG Collisions (Repair + Validation)

## Scope

- Detect overlaps/collisions in SVGs
- Apply safe layout fixes (move label backgrounds, adjust spacing)
- Re-run validation until clean

## Inputs

- SVG filepath
- Desired strictness (`--strict` vs normal)
- Whether collisions are *real* (text-on-rect label patterns are often intentional)

## Procedure

1. Run collision detection.
2. Inspect reported collisions by severity.
3. Fix only true problems (especially text-over-text).
4. Re-run strict mode before shipping.

## Validation

Run:

- `node tools/dev/svg-collisions.js <file> --strict`

## Escalation / Research request

Ask for dedicated research if:

- strict mode repeatedly reports false positives tied to viewBox scaling
- you need a new reusable theme/layout template under `data/svg-templates/` or `tools/dev/svg-templates/`

## References

- Tool doc: `tools/dev/README.md` (svg-collisions section)
- SVG methodology: `docs/guides/SVG_CREATION_METHODOLOGY.md`