In one sentence: click Use this template, edit one YAML file, push — your link page is live on GitHub Pages with a free *.github.io domain (or your own). No SaaS, no monthly fee, no vendor lock-in. AI-assisted theming and plugin development included.
First-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
config.yml
AI Style Designer. Describe the look you want in plain English; the bundled linkyee-style-designer Claude skill writes the full theme for you (HTML + CSS + JS).
6 built-in plugins for live data — GitHub stars, last commit, profile stats, RSS/Atom feeds, date countdowns, latest YouTube video.
AI Plugin Builder. Want data from somewhere else? Describe the source; the bundled linkyee-plugin-builder skill writes the Ruby plugin and wires it in.
SEO + accessibility built-in. WCAG AA contrast, dark mode, responsive down to 320 px, OG/Twitter meta, keyboard-friendly focus states.
Local preview with auto-rebuild../preview.sh rebuilds on save; refresh the browser, no plugins needed.
The shipped config.yml is a fully working example that exercises every built-in plugin — read it as the canonical reference. Edit fields in place, push, wait for GitHub Actions to rebuild, refresh.
Automatic redeployment
The site rebuilds automatically once a day so plugin output (star counts, latest posts, etc.) stays fresh. The cron lives in build.yml:
schedule:
- cron: '0 0 * * *' # daily at 00:00 UTC
Delete the schedule: block if you don't want scheduled redeploys.
Themes 🎨
linkyee ships 8 built-in themes designed to be drop-in usable. Switch by editing one line in config.yml:
theme: minimal-mono # any directory under ./themes/
Every built-in theme meets the same baseline: WCAG AA contrast, dark mode that auto-switches with your system appearance (no manual toggle), responsive down to 320 px, keyboard-accessible focus states, and prefers-reduced-motion support.
To try them locally before committing, see Local testing. To regenerate the preview screenshots above after any visual change, run ./scripts/screenshot-themes.sh (requires npx playwright).
Modifying a theme by hand
Each theme lives at ./themes/<theme-name>/ with three files:
scripts.js — can be empty, but the file must exist
The default theme self-hosts Font Awesome under themes/default/fontawesome/. The other built-ins load Font Awesome from a CDN to keep theme directories small.
🤖 AI Style Designer — generate a theme by description
Don't see a vibe you like? Describe it in plain English and the bundled linkyee-style-designer Claude skill writes a full theme for you.
"Design a linkyee theme inspired by 1960s Penguin paperback covers."
"Make my links look like a Japanese ryokan website — quiet, elegant, lots of negative space."
"I want a vaporwave aesthetic but keep it accessible."
The skill reads your config.yml, asks clarifying questions if the brief is vague, generates themes/<your-theme>/, switches theme: in config.yml, and runs the build.
Run ./preview.sh <new-theme> to see the result locally.
The skill enforces the same quality bar as the built-in themes: no AI slop (no unwarranted purple-pink gradients, no emoji-as-icons, no centered-everything-no-hierarchy), real typographic hierarchy, accessibility minimums, and strict RWD — mobile-first, ≥44 px tap targets, no horizontal scroll at 320 px.
Deeper design tooling. If you want a richer designer experience (multi-direction exploration, expert review, animation export), install the upstream huashu-design skill alongside it. The linkyee skill defers to huashu-design when both are present.
Plugins 🔌
Plugins are tiny Ruby classes that fetch data at build time and inject it into your page. Use them to render live values inside any link, the tagline, or the footer — anything that's a Liquid string.
Built-in plugins
| Plugin | What it emits | Reference shape |
|---|---|---|
| GithubRepoStarsCountPlugin | Star count for one or more repos | {{ vars.GithubRepoStarsCountPlugin['owner/repo'] }} |
| GithubLastCommitPlugin | Latest commit sha / date / message | {{ vars.GithubLastCommitPlugin['owner/repo'].date }} |
| GithubProfilePlugin | followers / following / repos | {{ vars.GithubProfilePlugin['user'].followers }} |
| RSSFeedPlugin | Latest items (Medium / blog / podcast / YouTube feeds) | {{ vars.RSSFeedPlugin['url'][0].title }} |
| CountdownPlugin | Days until / since a target date | {{ vars.CountdownPlugin.label.days }} |
| YouTubeChannelLatestVideoPlugin | Latest video — title,
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
