By name: personal-website description: | Generate a beautiful personal homepage (linktree-style) and publish it online for the user. Reads user info from ~/.clacky/agents/USER.md and AI info from ~/.clacky/agents/SOUL.md. Returns a public URL the user can share. Trigger on: "profile card", "homepage", "personal page", "generate my card", "make my card", "publish my card", "生成名片", "做名片", "我的名片", "个人主页", "发布主页", "delete my card", "删除名片", "删除主页". allowed-tools: - Bash - Read - Write
Profile Homepage Skill
Generate a beautiful personal homepage and publish it at a public URL.
Step 1 — Read user info
Read ~/.clacky/agents/USER.md and ~/.clacky/agents/SOUL.md.
Extract everything you can find:
name— display name (fallback: "Friend")occupation— job title or role (fallback: "")bio— short personal description (fallback: "")links— all social/contact links found, preserve their labels. Common ones to look for: GitHub, Twitter/X, LinkedIn, Website, Blog, Email, Instagram, YouTube, Telegram, WeChat, etc. Each link:{ label, url, type }where type helps pick an icon emoji.ai_name— AI assistant name from SOUL.md (fallback: "Clacky")personality— professional / friendly / creative / concise (from SOUL.md, fallback: "friendly")
Step 2 — Handle delete request
If the user asked to delete their homepage:
- Find the skill's own directory (same folder as this SKILL.md). Call it
SKILL_DIR. - Run:
The script reads the slug automatically fromruby SKILL_DIR/publish.rb delete~/clacky_workspace/personal_website/token.json. - Tell the user their homepage has been removed. Stop here.
Step 3 — Design & generate the HTML
Write a complete, self-contained HTML file to /tmp/profile-card.html.
You have full creative freedom on:
- Layout, typography, spacing, color palette
- Background (solid / gradient / subtle pattern / animated)
- Link button style (pill / card / underline / ghost / anything)
- Avatar treatment (large initial letter with color, emoji, geometric shape — no real image needed)
- Animations (subtle hover effects, entrance fade, etc.)
- Overall vibe — make it feel like a real personal brand page, not a template
Hard constraints (must follow):
- Single HTML file, zero external resources — no CDN, no Google Fonts URLs, no
<img src="http...">. Use system fonts:'Helvetica Neue', Arial, 'PingFang SC', 'Hiragino Sans GB', sans-serif - Mobile-first, responsive —
<meta name="viewport">required, works on phone screens - Valid HTML5
- All links open in
_blankwithrel="noopener" - Badge somewhere subtle:
made by {ai_name} personal assistant— small, not intrusive - Page
<title>:{name}'s Homepageor similar
Link icons (use emoji prefix in button text):
| Type | Emoji |
|---|---|
| github | 🐙 |
| twitter/x | 🐦 |
| 💼 | |
| website/blog | 🌐 |
| 📧 | |
| 📸 | |
| youtube | ▶️ |
| telegram | ✈️ |
| default | 🔗 |
Step 4 — Publish
Find the skill directory (same folder as this SKILL.md). Call it SKILL_DIR.
Run:
ruby SKILL_DIR/publish.rb publish \
--name "NAME" \
--html-file /tmp/profile-card.html
- First publish → creates new page, saves token to
~/clacky_workspace/personal_website/token.json - Subsequent runs → updates existing page at the same URL
Capture stdout. Extract the URL from the output line starting with ✅.
Step 5 — Done
Tell the user their homepage is live. Share the URL. Be warm and natural.
Example (adapt tone to personality):
Your homepage is live 🌟 → http://localhost:3000/~ya-fei
It's got all your links in one place. Share it anywhere.