← ClaudeAtlas

building-github-profileslisted

Use when creating or upgrading a GitHub profile README — animated or "futuristic" profiles, the <username>/<username> repo, animating contribution graphs (snake, 3D towers), showing stats when work lives in private repos, README images rendering broken, or GitHub Actions pipelines that keep profile assets fresh.
siddharth-searce/futurify-github-profile · ★ 0 · Data & Documents · score 67
Install: claude install-skill siddharth-searce/futurify-github-profile
# Building GitHub Profiles ## Overview READMEs allow no JS, no CSS, no hover — but CSS/SMIL animations *inside* an SVG run when it's loaded via `<img>`. Core principle: **own every pixel** — generate and post-process SVGs in the profile repo at build time instead of hotlinking view-time services. Hotlinked cards break (the official github-readme-stats instance has been down for extended periods) and die behind corporate proxies; committed assets don't. ## The technique that beats stock output: post-process generated SVGs Generators (Platane/snk, yoshi389111/github-profile-3d-contrib) emit deterministic SVG that a small Python script in the repo can rewrite: - **Custom entrance animations:** strip the generator's SMIL (`<animate…>` elements — static attributes already hold final state), wrap each element in `<g class="…" style="animation-delay:…">`, inject CSS keyframes. Example: towers "sky-drop" with `cubic-bezier(.3,1.35,.45,1)` bounce, staggered per grid cell. - **3d-contrib grid basis** (1280×850 canvas): tile(col,row) = `(140,154.18) + col·(20,11.545) + row·(−20,11.545)`. Floor tiles are the gray-fill groups (`rgb(68,68,68)`/57/48); towers are the colored ones. This basis lets you project any 16px-grid content (e.g. the snk snake body) onto the isometric floor with one matrix transform — CSS translate animations compose through it, so motion becomes isometric too. - **Compose multiple SVGs into one component** via nested `<svg x y width height>` (each keeps its own