Communitygithub.com

clacky-ai/openclacky

Genera una hermosa página de inicio personal (estilo linktree) y publícala en línea para el usuario. Lee información del usuario de ~/.clacky/agents/USER.md e información de IA de ~/.clacky/agents/SOUL.md. Devuelve una URL pública que el usuario puede compartir.

¿Qué es openclacky?

Esta habilidad para agentes de IA como Claude Code, Cursor o Codex permite generar y publicar una página de inicio personal visualmente atractiva (similar a Linktree/Bento) con un solo comando. El agente lee automáticamente la información del usuario desde `~/.clacky/agents/USER.md` y los detalles de personalidad de la IA desde `~/.clacky/agents/SOUL.md`, extrayendo nombre, ocupación, biografía y todos los enlaces sociales y de contacto. Luego diseña una página HTML completa y autocontenida (sin recursos externos, con emojis como íconos de enlaces y tipografía del sistema) y la publica a través de un script Ruby complementario (`publish.rb`), devolviendo una URL pública compartible. También admite la eliminación de la página existente bajo petición. La salida es un archivo HTML único, responsivo, mobile-first, con libertad creativa en diseño, animaciones y paleta de colores, ideal para que desarrolladores y usuarios técnicos creen rápidamente una presencia web profesional mínima.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Vista previa

Del README del skill

openclacky preview

Documentación

Habilidad de Página de Inicio Personal

Genera una hermosa página de inicio personal y publícala en una URL pública.


Paso 1 — Leer información del usuario

Lee ~/.clacky/agents/USER.md y ~/.clacky/agents/SOUL.md.

Extrae todo lo que puedas encontrar:

  • name — nombre para mostrar (fallback: "Amigo")
  • occupation — cargo o rol (fallback: "")
  • bio — descripción personal breve (fallback: "")
  • links — todos los enlaces sociales/de contacto encontrados, conserva sus etiquetas. Los más comunes a buscar: GitHub, Twitter/X, LinkedIn, Sitio web, Blog, Correo electrónico, Instagram, YouTube, Telegram, WeChat, etc. Cada enlace: { label, url, type } donde type ayuda a elegir un emoji de icono.
  • ai_name — nombre del asistente de IA desde SOUL.md (fallback: "Clacky")
  • personality — profesional / amigable / creativo / conciso (desde SOUL.md, fallback: "amigable")

Paso 2 — Manejar solicitud de eliminación

Si el usuario pidió eliminar su página de inicio:

  1. Encuentra el directorio propio de la habilidad (misma carpeta que este SKILL.md). Llámalo SKILL_DIR.
  2. Ejecuta:
    ruby SKILL_DIR/publish.rb delete
    
    El script lee el slug automáticamente desde ~/clacky_workspace/personal_website/token.json.
  3. Dile al usuario que su página de inicio ha sido eliminada. Detente aquí.

Paso 3 — Diseñar y generar el HTML

Escribe un archivo HTML completo y autocontenido en /tmp/profile-card.html.

Tienes libertad creativa total para:

  • Diseño, tipografía, espaciado, paleta de colores
  • Fondo (sólido / degradado / patrón sutil / animado)
  • Estilo de botones de enlace (píldora / tarjeta / subrayado / fantasma / cualquier otro)
  • Tratamiento del avatar (letra inicial grande con color, emoji, forma geométrica — no se necesita imagen real)
  • Animaciones (efectos hover sutiles, desvanecimiento de entrada, etc.)
  • Ambiente general — haz que se sienta como una verdadera página de marca personal, no una plantilla

Restricciones estrictas (deben cumplirse):

  • Archivo HTML único, cero recursos externos — nada de CDN, URLs de Google Fonts, ni <img src="http...">. Usa fuentes del sistema: 'Helvetica Neue', Arial, 'PingFang SC', 'Hiragino Sans GB', sans-serif
  • Mobile-first, responsive — se requiere <meta name="viewport">, funciona en pantallas de teléfono
  • HTML5 válido
  • Todos los enlaces se abren en _blank con rel="noopener"
  • Insignia en algún lugar sutil: hecho por {ai_name} asistente personal — pequeña, no intrusiva
  • Título de la página <title>: Página de {name} o similar

Iconos de enlaces (usa prefijo emoji en el texto del botón):

TipoEmoji
github🐙
twitter/x🐦
linkedin💼
website/blog🌐
email📧
instagram📸
youtube▶️
telegram✈️
default🔗

Paso 4 — Publicar

Encuentra el directorio de la habilidad (misma carpeta que este SKILL.md). Llámalo SKILL_DIR.

Ejecuta:

ruby SKILL_DIR/publish.rb publish \
  --name "NOMBRE" \
  --html-file /tmp/profile-card.html
  • Primera publicación → crea nueva página, guarda token en ~/clacky_workspace/personal_website/token.json
  • Ejecuciones posteriores → actualiza la página existente en la misma URL

Captura stdout. Extrae la URL de la línea de salida que comienza con ✅.


Paso 5 — Listo

Dile al usuario que su página de inicio está en línea. Comparte la URL. Sé cálido y natural.

Ejemplo (adapta el tono a la personalidad):

¡Tu página de inicio está en línea 🌟 → http://localhost:3000/~ya-fei

Tiene todos tus enlaces en un solo lugar. Compártela donde quieras.

Individual skills in this repo

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

Skills relacionados