Personal Website
Designpersonal-websitePersonal Website is an Agent Skill for design published in the clacky-ai/openclacky repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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", "删除名片", "删除主页".
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/clacky-ai/openclacky/blob/HEAD/lib/clacky/default_skills/personal-website/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/personal-website, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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.