Communitygithub.com

Profile Homepage Skill

Generate a beautiful personal homepage (linktree-style) and publish it online for the user.

What is Profile Homepage Skill?

This skill enables an AI assistant to generate a fully self-contained, mobile-first personal homepage (like Linktree) for the user and publish it to a public URL. It first reads the user's profile information from `~/.clacky/agents/USER.md` and AI assistant personality from `~/.clacky/agents/SOUL.md`. The assistant then creates a single, zero-dependency HTML file with custom design, emoji link icons for social profiles, and a subtle AI assistant badge. The HTML is published via a Ruby script, which returns a shareable URL; the user can also delete their homepage on request. Supported platforms include Claude Code, Cursor, Codex, and other AI agent frameworks that can execute shell commands and read local files.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/clacky-ai/openclacky/tree/HEAD/lib/clacky/default_skills/personal-website

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Preview

From the skill README

Profile Homepage Skill preview

Documentation

What does Profile Homepage Skill do?

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):

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

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Related Skills