Communitygithub.com

claude-workflow-skills

Inicia un sitio web de portafolio personal desde la plantilla donotdonuts.github.io. Recopila nombre, foto, currículum, URLs sociales y preferencia de estilo visual, luego genera la línea de tiempo, las tarjetas de proyectos y el conocimiento del chatbot a partir del currículum, aplicando una paleta de colores a medida. Incluye un chatbot opcional con DeepSeek detrás de un Cloudflare Worker. Se despliega estáticamente en GitHub Pages.

¿Qué es claude-workflow-skills?

Este skill automatiza la creación de un sitio web de portafolio personal estático y de una sola página, alojado en GitHub Pages, a partir de la plantilla `donotdonuts.github.io`. Está diseñado para agentes de IA como Claude Code, Cursor o Codex, y guía al usuario paso a paso en la recolección de datos (nombre, foto, currículum, enlaces a redes sociales) y preferencias de estilo visual (ya sea mediante una URL de referencia o una descripción textual). El agente genera automáticamente una línea de tiempo profesional, tarjetas de proyectos plegables y un chatbot opcional con IA, todo ello extraído del currículum del usuario. El skill maneja la creación del repositorio en GitHub, la clonación de la plantilla, la personalización de la paleta de colores (13 tokens CSS), la inserción del contenido dinámico en el HTML, la configuración de un Cloudflare Worker para el chatbot (si se desea) y el despliegue final. Su utilidad principal es permitir que cualquier usuario, incluso sin conocimientos técnicos profundos, obtenga un portafolio profesional y moderno en minutos, con una arquitectura fija pero totalmente personalizable en apariencia y contenido, incluyendo un asistente virtual con nombre y avatar emoji personalizados.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/donotdonuts/claude-workflow-skills/tree/HEAD/skills/random-skills/personal-site-setup

Preguntar en tu IA favorita

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

Documentación

Configuración del sitio personal

Guía a un nuevo usuario para lanzar su propio portafolio en https://<su-nombre-de-usuario>.github.io. La arquitectura es fija; la apariencia, el contenido y la personalidad del chatbot se personalizan para cada usuario.

Qué obtiene

  • Sitio estático de una sola página, sin empaquetador. GitHub Pages sirve main desde la raíz del repositorio.
  • Hero — su retrato + nombre + ubicación en una línea + eslogan en una línea.
  • Sección de proyectos con una línea de tiempo vertical atenuada en el encabezado de la sección (iconos de llave inglesa para trabajo, libro para educación, destellos para proyectos paralelos / vibra; cada punto muestra empresa, rol, fecha, ubicación) y una cuadrícula de tarjetas de proyecto en el cuerpo, ambas generadas a partir del currículum del usuario.
  • Filtro de línea de tiempo ↔ tarjetas — al pasar el ratón o enfocar con teclado un punto de la línea de tiempo se ocultan las tarjetas de proyecto no relacionadas; al hacer clic se fija el filtro (otro clic lo limpia). Solo los puntos que tienen al menos una tarjeta asociada se vuelven interactivos; los demás permanecen inertes.
  • Tarjetas plegables — cada tarjeta de proyecto muestra solo su categoría + título + etiquetas de herramientas por defecto; el párrafo de resumen y la fila de métricas aparecen al pasar el ratón / enfocar, manteniendo la cuadrícula escaneable.
  • Chatbot (opcional) — un lanzador flotante en la esquina inferior derecha + un panel emergente (no una sección en línea de la página) respaldado por la API compatible con OpenAI de DeepSeek detrás de un Cloudflare Worker que contiene la clave API. El usuario elige el nombre del bot; el agente propone un avatar emoji acorde. Las respuestas del bot renderizan markdown. Límite de tasa de dos capas.
  • Sección de contacto — correo electrónico + las URLs sociales del usuario.

Requisitos previos

Necesario paraHerramientaInstalación
Todogitnormalmente ya instalado
TodoCuenta de GitHub + CLI ghbrew install gh luego gh auth login
Todopython3 (vista previa local)normalmente ya instalado
ChatbotCuenta de Cloudflare (nivel gratuito)https://dash.cloudflare.com
ChatbotCLI wranglernpm install -g wrangler luego wrangler login
ChatbotClave API de DeepSeekhttps://platform.deepseek.com/ → API keys
Cambio de retratoNode.jsbrew install node

Paso a paso

1. Recopilar entradas del usuario

Haga esto antes de tocar cualquier archivo. Recopile todo de una vez para que los pasos posteriores sean ediciones automatizadas. Combine AskUserQuestion para opciones múltiples y mensajes directos para texto libre.

Obtenga cada uno de estos del usuario:

EntradaCómo preguntarEjemplo
Nombre de usuario de GitHubdirectojane (el repositorio será jane.github.io)
Nombre para mostrardirectoJane Doe o Jane "JD" Doe
Frase de ubicacióndirecto, cortoÁrea metropolitana de NY, Remoto, Tokio
Eslogandirecto, una oraciónConstruyo sistemas de ML y me encanta enviar productos.
Currículumpegar texto o ruta a un archivocurrículum completo: se usa para poblar la línea de tiempo, las tarjetas de proyecto y el conocimiento del chatbot
Fotoruta a una imagen cuadrada en disco/Users/jane/Desktop/headshot.jpg. El usuario puede colocarla en la raíz del repositorio como raw.jpg después de clonar.
URLs socialesdirecto, cada una opcionalPerfil de LinkedIn / GitHub / Medium / correo personal
¿Chatbot?AskUserQuestionsí / no
Nombre del chatbot (si sí)directoPot, Nova, Echo, etc.
Estilo visualAskUserQuestion"Pegue una URL que me guste" O "Descríbalo con palabras"

Después de recopilar el nombre del chatbot, proponga 2 o 3 avatares emoji que combinen temáticamente y deje que el usuario elija. Ejemplos:

NombreAvatares propuestos
Pot🫖 (tetera) · 🍲 · 🎨
Nova🌟 · 💫 · 🌠
Echo📣 · 🔊 · 🌀
Ember🔥 · 🪵 · ✨
Atlas🗺️ · 🧭 · 🌍
Bit💾 · 🔢 · 🤖
Sage🌿 · 📖 · 🦉

Si nada obvio encaja, ofrezca neutros: 🤖, 💬, 🪄. Guarde el emoji elegido + el nombre; los escribirá en el código más tarde.

2. Crear el repositorio de GitHub

gh repo create <nombre-de-usuario>.github.io --public --description "Sitio web personal"

Los sitios de usuario de GitHub Pages DEBEN estar en <nombre-de-usuario>.github.io.

3. Clonar la plantilla

git clone https://github.com/donotdonuts/donotdonuts.github.io mi-sitio
cd mi-sitio
rm -rf .git
git init -b main
git remote add origin https://github.com/<nombre-de-usuario>/<nombre-de-usuario>.github.io.git

4. Elegir un estilo visual

La plantilla usa por defecto una estética crema + IBM Plex Mono. Sobrescríbala según la respuesta del usuario del Paso 1.

4a. Si el usuario proporcionó una URL

Extraiga el CSS de la página y extraiga los tokens:

curl -sL "<url>" -o /tmp/ref.html
grep -oE 'href="[^"]+\.css[^"]*"' /tmp/ref.html | sort -u
curl -sL "<origen>/<ruta-css>" -o /tmp/ref-1.css

# fuente realmente aplicada al body
grep -oE 'body[^{]{0,30}\{[^}]+\}' /tmp/ref-1.css | head -5
# todas las definiciones de propiedades personalizadas CSS
grep -oE -- '--[a-zA-Z-]+:[^;}]+' /tmp/ref-1.css | sort -u | head -60

Busque: hex de fondo, hex de primer plano/tinta, hex de borde, hex de acento, font-family aplicada al body, URLs de @font-face.

4b. Si el usuario proporcionó una descripción

Traduzca la descripción a tokens concretos. Heurísticas:

PalabrasImplicación
"mínimo", "editorial", "papel"Fondo crema / blanco roto, tinta oscura, divisores finos
"oscuro", "terminal", "IDE"Fondo casi negro (#0f1115), tinta clara, bordes grises sutiles
"cálido", "analógico"Crema ligeramente amarillento (#faf5e8), tinta marrón-negro
"brutalista"Blanco puro o negro puro, bordes sólidos de 2px+
"tecnológico", "datos"Monoespaciada (IBM Plex Mono, JetBrains Mono), grises fríos
"revista", "editorial"Serif (EB Garamond, Fraunces), interlineado generoso
"divertido"Un acento saturado, por lo demás apagado

4c. Proponer + aplicar

Compile 13 tokens + una pila de fuentes. Muestre la paleta propuesta como un bloque de código y obtenga aprobación antes de editar archivos.

:root {
  --bg:             <hex>;   /* fondo de página */
  --bg-soft:        <hex>;   /* subpaneles — normalmente --bg mezclado ~3% hacia --ink */
  --bg-hover:       <hex>;   /* hover de etiqueta/chip */
  --card-bg:        <hex>;   /* relleno de tarjeta opaco (blanco si tema claro) */
  --ink:            <hex>;   /* texto principal */
  --ink-soft:       <hex>;   /* ~80% de --ink */
  --ink-mute:       <hex>;   /* ~60% */
  --ink-faint:      <hex>;   /* ~40% */
  --border:         <hex>;   /* divisores sutiles */
  --border-strong:  <hex>;   /* divisores importantes */
  --up:             <hex>;   /* métricas positivas (verdoso por defecto) */
  --down:           <hex>;   /* métricas negativas (rojizo por defecto) */
  --accent-ink:     <hex>;   /* enlaces */
  --font-mono:      "<Familia>", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

Luego:

  1. Abra css/styles.css, encuentre el bloque :root, reemplace los valores.
  2. Abra index.html, actualice el enlace <link> de Google Fonts en <head> con la nueva familia de fuentes + pesos.

5. Generar contenido a partir del currículum y las entradas

Use el currículum y otras entradas del Paso 1 para poblar index.html:

  1. <head> — <title> = <Nombre para mostrar> — <primer-rol-del-currículum>; <meta name="description"> a partir del eslogan.

  2. Hero:

    • <h1 class="hero-title"> ← nombre para mostrar
    • <p class="hero-location"> ← frase de ubicación
    • <p class="hero-tagline"> ← eslogan
  3. Línea de tiempo — analice el currículum en puntos. Un <li class="tl-stop"> por rol, por título, Y por cada categoría de proyecto paralelo personal en curso que el usuario quiera mostrar. Orden presente → más antiguo (de arriba a abajo en el DOM). Elija un slug corto data-experience para cada uno (por ejemplo, mars, vibe, coach, gatech) — es lo que el filtro usa para vincular puntos con tarjetas. Agregue tabindex="0" solo en puntos que tengan ≥1 tarjeta de proyecto vinculada (los demás permanecen inertes).

    <li class="tl-stop tl-stop-trabajo" data-experience="<slug>" tabindex="0">
      <!-- tl-stop-trabajo | tl-stop-edu | tl-stop-vibe   (elegir uno) -->
      <svg class="tl-icon tl-icon-trabajo" aria-hidden="true">
        <use href="#icon-wrench"/>       <!-- #icon-wrench | #icon-book | #icon-sparkle -->
      </svg>
      <div class="tl-info">
        <strong>Empresa / Universidad</strong>
        <span>Rol / Título</span>
        <em>Inicio — Fin</em>
        <i class="tl-loc">Ciudad, Estado</i>
      </div>
    </li>
    

    Elimine tabindex="0" en puntos de educación / roles antiguos que no tengan tarjetas de proyecto vinculadas — js/main.js los detecta automáticamente al cargar y los deja no interactivos.

  4. Proyectos — ~seis bloques <article class="project-card">, generados a partir de proyectos/logros notables en el currículum. Cada tarjeta DEBE llevar un slug data-experience que coincida con el punto del que proviene, o no participará en el filtro:

    <article class="project-card" data-experience="<slug>">
      <header class="project-head">
        <span class="project-tag">Categoría</span>
        <h3>Título del proyecto</h3>
      </header>
      <p>Resumen de 1 a 2 oraciones extraído de la viñeta del currículum.</p>
      <dl class="project-metrics">
        <div><dt>Métrica</dt><dd class="up">+valor</dd></div>
        <div><dt>Métrica</dt><dd>valor</dd></div>
      </dl>
      <ul class="tag-list small"><li>Herramienta</li><li>Herramienta</li></ul>
    </article>
    

    Use <dd class="up"> / <dd class="down"> para colorear las métricas. Las tarjetas se renderizan plegadas por defecto — solo la etiqueta, el título y las etiquetas de herramientas son visibles hasta que el hover / focus-within revela el resumen + las métricas. Mantenga los resúmenes concisos; solo existen para recompensar un hover.

  5. Saludo del chat — el mensaje de apertura del bot es HTML en línea dentro de #chat-panel en index.html (dentro del <div class="chat-log"> del panel), por lo que se renderiza instantáneamente cuando el usuario abre el panel emergente por primera vez. Reescríbalo usando el nombre del bot elegido + el emoji avatar. Formato:

    <div class="chat-msg chat-msg-bot">
      <span class="chat-avatar" aria-label="<Nombre del bot>">EMOJI</span>
      <div class="chat-bubble">
        <p>Hola, soy <strong><Nombre del bot></strong> — el asistente de IA de <Nombre para mostrar>, <verbo> a partir de <su/su(s)> currículum.</p>
        <p>Pregúntame sobre:</p>
        <ul>
          <li>Empresas / roles</li>
          <li>Métodos / enfoques</li>
          <li>Proyectos / habilidades / educación</li>
        </ul>
        <p>¿Qué te gustaría saber?</p>
      </div>
    </div>
    
  6. Conectar — correo electrónico + cada URL social proporcionada como un <li> en .connect-list. Elimine las filas de cualquier plataforma no proporcionada.

6. Agregar el retrato

Pregunte dónde está su foto. Cópiela a la raíz del repositorio como raw.jpg, luego cambie el tamaño:

cp <ruta-foto-usuario> raw.jpg
mkdir -p assets
sips -Z 720 raw.jpg --out assets/portrait.jpg

Si el fondo de la foto no coincide con el nuevo --bg, cámbielo con el script incluido:

cd /tmp && rm -rf img-fix && mkdir img-fix && cd img-fix
npm init -y > /dev/null
npm install [email protected] --silent
node <ruta-de-este-skill>/scripts/shift-portrait.js \
  /ruta/a/mi-sitio/raw.jpg \
  /ruta/a/mi-sitio/assets/portrait.jpg \
  "#<su-hex-de-fondo>"

Por defecto usa #fbf7eb si se omite el tercer argumento. raw.jpg está en .gitignore.

7. Configurar el chatbot (omitir si el usuario dijo que no)

7a. Worker

cd worker
wrangler login
wrangler secret put DEEPSEEK_API_KEY

worker/wrangler.toml:

ALLOWED_ORIGIN = "https://<nombre-de-usuario>.github.io,http://localhost:8000,http://127.0.0.1:8000"
MODEL          = "deepseek-chat"

worker/worker.js → SYSTEM_PROMPT — reescríbalo a partir del currículum del usuario. Mantenga la estructura de secciones (Acerca de / Rol actual / Roles anteriores / Educación / Caja de herramientas). También reescriba la oración de presentación del bot usando el nombre + avatar:

const SYSTEM_PROMPT = `Eres "<Nombre del bot>" <EMOJI> — un asistente de IA amigable y conciso integrado en el sitio web personal de <Nombre para mostrar>. …`;

Despliegue:

wrangler deploy

7b. Cliente

js/config.js:

window.SITE_CONFIG = {
  chatWorkerUrl: "https://<worker>.workers.dev",
};

js/chatbot.js — actualice las constantes al inicio:

const AVATAR = "<EMOJI>";
const AVATAR_LABEL = "<Nombre del bot>";

8. Vista previa + subir

python3 -m http.server 8000       # http://localhost:8000

Revise cada sección. Pruebe el chat. Cambie el tamaño a ancho móvil. Luego:

git add .
git commit -m "inicial: sitio personal"
git push -u origin main

En vivo en https://<nombre-de-usuario>.github.io/ en aproximadamente 60 segundos.

Arquitectura de la plantilla (no cambiar)

Diseño de secciones

Cada sección usa .section-grid: 280px 1fr. La columna de 280px se ajusta a la etiqueta de línea de tiempo más larga. Ajústela a 240px si todas las etiquetas son cortas, amplíe a 320px si son largas.

Línea de tiempo

  • Vive dentro del section-head de Proyectos, justo debajo del título, con opacity: 0.45. Al pasar el ratón, enfocar o con un filtro activo, se eleva a 0.95.
  • Orden del DOM = orden visual de arriba a abajo. Presente → más antiguo. NO proporcional al tiempo — distribuido uniformemente mediante flex gap.
  • Tres tipos de iconos listos para usar: #icon-wrench (trabajo, .tl-stop-work), #icon-book (educación, .tl-stop-edu), #icon-sparkle (vibra / proyecto paralelo, .tl-stop-vibe). Las tres definiciones <symbol> viven en el sprite SVG justo después de <header>. Para agregar una nueva categoría de icono:
    1. Agregue un <symbol id="icon-foo"> con su ruta SVG
    2. Agregue .tl-icon-foo { color: var(--ink-mute); }
    3. Haga referencia con <svg class="tl-icon tl-icon-foo"><use href="#icon-foo"/></svg>
  • Cada punto lleva data-experience="<slug>"; los puntos cuyo slug coincide con al menos una tarjeta de proyecto también obtienen tabindex="0" para que js/main.js pueda hacerlos interactivos para el filtro.

Filtro de proyectos (clic + hover)

Impulsado enteramente por js/main.js, sin configuración — escanea el DOM al cargar y conecta manejadores solo donde se aplican.

  • Al cargar, cada punto cuyo slug data-experience esté presente en al menos una .project-card obtiene .tl-stop-has-projects + role="button" + aria-pressed="false". Los puntos sin tarjetas vinculadas permanecen inertes.
  • Hover / focus en un punto interactivo → filtro temporal: las tarjetas no coincidentes se convierten en .is-dim (la cuadrícula agrega .is-filtering, que CSS traduce en display: none en las tarjetas atenuadas — se eliminan del diseño, no solo se atenúan).
  • Clic (o Enter / Space) → bloqueo: el punto obtiene .is-locked, opacidad completa, icono coloreado con tinta, nombre de la empresa subrayado. Haga clic en el mismo punto nuevamente para limpiar; haga clic en otro para cambiar.
  • Mientras está bloqueado, al pasar el ratón por un punto diferente se previsualizan sus tarjetas; mouseleave en el carril (o focusout fuera de él) vuelve al punto bloqueado.

Skills relacionados