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:

1. Find the skill's own directory (same folder as this SKILL.md). Call it

   SKILL_DIR

   .
2. Run:

   ruby SKILL_DIR/publish.rb delete
   

   The script reads the slug automatically from

   ~/clacky_workspace/personal_website/token.json

   .
3. 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

  _blank

  with

  rel="noopener"

• Badge somewhere subtle:

  made by {ai_name} personal assistant

  — small, not intrusive
• Page

  <title>

  :

  {name}'s Homepage

  or similar

Link icons (use emoji prefix in button text):

Type	Emoji
github	🐙
twitter/x	🐦
linkedin	💼
website/blog	🌐
email	📧
instagram	📸
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.