Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/trending-skills --skill git-city-3d-github-visualization -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/git-city-3d-github-visualization/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/git-city-3d-github-visualization/

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.

Similar skills

Everything for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set42

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor