git-city-3d-github-visualization — Claude Code skill: GitHub as a 3D
A skill for building on Git City, a project that turns GitHub profiles into 3D pixel-art buildings with Next.js and Three.js.
npx skills add reason-machines/trending-skills --skill git-city-3d-github-visualization -a claude-codeWhat git-city-3d-github-visualization does
Git City maps GitHub data onto buildings: height comes from contributions, width from public repos, window brightness from stars. The skill hands your agent a map of that codebase so a change to the renderer or the metric logic does not break the rest of the scene.
It covers the layout of app/, components/city/ and lib/, plus code patterns: metric calculation in lib/buildings.ts, the Building.tsx component on React Three Fiber, instanced window rendering with InstancedMesh, GitHub API calls through Octokit. A separate LOD manager handles level of detail.
Running it locally means cloning the repo, npm install, and filling .env.local with Supabase keys, GITHUB_TOKEN, and ADMIN_GITHUB_LOGINS if you want /admin/ads. Skip the GitHub token and some metrics never arrive, so set it up before the first run.
What it helps with
- add a feature to the Git City project
- change the 3D building renderer without breaking the scene
- set up Git City locally with Supabase keys
- add achievements and building decorations
- extend the GitHub profile visualization
Example prompts for the agent
- add a feature to git city
- set up git city locally
- modify the 3d building renderer in components/city/Building.tsx
How to install git-city-3d-github-visualization
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill git-city-3d-github-visualization -a claude-code2Manually: put the files in place
~/.claude/skills/git-city-3d-github-visualization/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/git-city-3d-github-visualization/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill git-city-3d-github-visualization -a codex2Manually: put the files in place
.agents/skills/git-city-3d-github-visualization/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill git-city-3d-github-visualization -a cursor2Manually: put the files in place
.cursor/skills/git-city-3d-github-visualization/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills git-city-3d-github-visualization2Manually: put the files in place
.github/skills/git-city-3d-github-visualization/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill git-city-3d-github-visualization -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/git-city-3d-github-visualizationManually: put the files in place
.devin/skills/git-city-3d-github-visualization/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill git-city-3d-github-visualization -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about git-city-3d-github-visualization
How do I install git-city-3d-github-visualization in Claude?
Run npx skills add reason-machines/trending-skills --skill git-city-3d-github-visualization -a claude-code. The skill lands in ~/.claude/skills/git-city-3d-github-visualization/SKILL.md.
What does this skill do?
It guides an agent through work on Git City: the 3D building renderer, profile metrics, achievements, and the admin panel, while keeping the project structure intact.
What do I need to run Git City locally?
Clone the repo, install dependencies with npm install, and fill .env.local with Supabase keys and a GITHUB_TOKEN.