generate-tech-stack
Scan the current project and produce a complete visual tech stack page.
Steps
Locate the project root — use the current working directory unless the user specified a path.
Run the analyzer:
python3 ~/.claude/skills/generate-tech-stack/scripts/analyze.py <project_root> <project_root>/TECH_STACK.htmlOpen the output:
xdg-open <project_root>/TECH_STACK.html 2>/dev/null || open <project_root>/TECH_STACK.html 2>/dev/null || trueReport to the user — include:
- Number of tools detected and categories found
- Clickable link to the output file
- One-line per-category breakdown from the script's stdout
Output format
The generated HTML must include all of the following sections (the script produces all of them automatically):
- Stat row — large number tiles: Total Tools · Categories · AI Backends (if any) · Data Stores
- Architecture diagram — layered flow:
- Row 1: Your Application / LLM Application (purple box)
- Row 2: Web/API framework(s) (green box with auth/middleware subtitle)
- Row 3: AI SDK boxes side-by-side (blue, one per backend — only if AI SDKs detected)
- Row 4: Database boxes + Observability + Frontend (dark row)
- Bar chart summary — horizontal bars, one per category, colour-matched
- Tool cards grid — one card per category with:
- Coloured icon box + category title + tool count in the header
- Each tool: colour dot · name · description · badge pill
- Footer — project name · tool count · generation date
- Guided tour — a spotlight walkthrough that dims the page and steps through each section
in turn (Back/Next/Skip), shown automatically the first time a generated report is opened.
Replayable anytime via the
?button in the top-right corner. - Theme toggle — sun/moon button beside the tour button switches between dark (default) and light mode.
Design tokens (default dark theme)
| CSS variable | Value | Usage |
|---|---|---|
--bg |
#0f172a |
Page background |
--bg2 |
#111827 |
Secondary background |
--bg3 |
#161e2e |
Card / chart background |
--bg4 |
#1a2535 |
Elevated surface |
--border |
#1e293b |
Card / section borders |
--border2 |
#263347 |
Hover border |
--text |
#f1f5f9 |
Primary text |
--muted |
#64748b |
Secondary / label text |
--dim |
#334155 |
Footer / divider text |
--green |
#22c55e |
Accent (badge dot, stat highlight) |
--mono |
'JetBrains Mono', monospace |
Code / badge font |
--sans |
'IBM Plex Sans', system-ui, sans-serif |
Body font |
Fonts are loaded from Google Fonts:
IBM Plex Sans:wght@300;400;500;600;700
JetBrains Mono:wght@400;500;600
Heading h1: color:#f8fafc, no gradient. Bar chart track: background:#0a0f1a.
Fallback (script not found)
If ~/.claude/skills/generate-tech-stack/scripts/analyze.py cannot be found:
- Read
requirements.txt,package.json,go.mod,Cargo.toml,pyproject.toml - Check for
Dockerfile,docker-compose.yml,.github/workflows/,alembic.ini - Identify each tool's category and purpose
- Write
TECH_STACK.htmlusing the design tokens and section structure above
Notes
- Always overwrite an existing
TECH_STACK.html— never ask for confirmation - Works on Python, Node.js, Go, Rust, Java, Ruby, PHP projects
- The architecture diagram adapts to what is detected: layers are omitted if their category is empty