Skip to content

harrisliangsu/dark-tech-style

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

English · 简体中文

dark-tech-style

A Claude Code / Claude.ai skill that gives Claude a complete, opinionated visual style for building dark-themed technical web pages: architecture overviews, product showcases, dashboards, roadmaps, technical landing pages, one-pagers.

Style fingerprint

Hero of docs/demo.html — a fictional "Tessera" deploy-pipeline page rendered entirely from this skill's tokens and components. See the full demo and the SaaS variant in the gallery below.

What you get

A signature aesthetic: near-black 4-level background, barely-there 6% borders, ultra-tight 800-weight headlines, a 7-color accent palette with dim variants, glassmorphic nav, gradient stat numbers, and 14 ready-to-use component classes.

Gallery

Same skill, different content. Both pages were generated from assets/tokens.css + assets/starter.html, no per-page custom CSS.

Tessera · deploy pipeline Drift · SaaS landing
Tessera demo Drift demo
Engineering-process feel: horizontal 6-stage pipeline, asymmetric maturity ladder with "you-are-here" highlight, horizontal Gantt roadmap with quarter columns. Product-marketing feel: trusted-by logo strip, asymmetric 1-large + 2-small feature highlight with code snippet, big-number social proof, 3-tier pricing, terminal CTA.

Style fingerprint

  • Background: #0a0c14#10121c#161924#1c1f2e (four levels)
  • Text: #e2e5ef / #7a7f96 / #4a4e63 (three levels, no pure white)
  • Borders: rgba(255,255,255,0.06), lifts to 0.12 on hover
  • Accents: orange / blue / green / gold / purple / red / cyan — each with a 15%-alpha dim variant
  • Type: SF Pro / PingFang for body; SF Mono / Fira Code for code
  • Headlines: font-weight: 800, letter-spacing: -0.02em to -0.03em
  • Radii: 14px for cards, 8px for chips
  • Effects: 20px backdrop-blur nav, radial-gradient hero halo, pulse animation on status dots, 135° gradient text for stats

Install

Claude Code

git clone https://github.com/harrisliangsu/dark-tech-style.git ~/.claude/skills/dark-tech-style

Or clone elsewhere and symlink:

git clone https://github.com/harrisliangsu/dark-tech-style.git ~/dev/repo/dark-tech-style
ln -s ~/dev/repo/dark-tech-style ~/.claude/skills/dark-tech-style

Restart Claude Code (or start a new session) and the skill will appear in the available-skills list.

Claude.ai

Upload the directory as a custom skill via Settings → Skills.

Usage

Just describe what you want to build:

  • "Architecture page, 6-stage pipeline, with a roadmap"
  • "Landing page for an AI coding agent, dark theme, 4 hero stats"
  • "Tech briefing one-pager: 3-layer architecture + defense mechanisms + KPIs"
  • "Dashboard overview, dark tech style"

The skill auto-triggers and Claude will pull the design tokens, pick an accent color per section, and output a single-file HTML page using the component recipes.

You can also invoke it explicitly:

/dark-tech-style help me build an architecture page for a KMS system

Repository layout

dark-tech-style/
├── SKILL.md              # rules, color laws, section patterns, anti-patterns
├── assets/
│   ├── tokens.css        # CSS variables + 14 component classes
│   └── starter.html      # section skeletons (hero / cards / layers / timeline / terminal)
├── docs/
│   ├── demo.html         # architecture overview example
│   ├── demo-saas.html    # SaaS landing example
│   ├── preview.png       # rendered architecture preview
│   └── preview-saas.png  # rendered SaaS landing preview
├── README.md             # English
├── README.zh.md          # Simplified Chinese
└── LICENSE

Three rules that matter most

These are the rules you'll see Claude apply — they're the ones most often violated when this style gets imitated by hand:

  1. One accent per section. Pick a color (orange / blue / green / etc.) and use it for every element in that section — kicker, card rail, badge, dot, stat gradient. Don't mix.
  2. -dim variants are backgrounds only. Never use a 15%-alpha color as text — it's unreadable. Use the solid accent for text/border/icon, the -dim variant only for fills.
  3. Take colors from tokens, never hardcode hex. If you find yourself typing #3b82f6, use var(--accent-blue) instead.

Credits

The visual language was extracted from a "Ship Rail" architecture page authored by YiKong (易空) — credit to the original designer for the aesthetic. This repo packages the system as a reusable Claude skill.

License

MIT — see LICENSE.

About

Dark tech-style design system for Claude Code / Claude.ai — turns one-line requests into consistent dark-themed architecture pages, dashboards, and technical landings.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors