Communitygithub.com

donotdonuts/claude-workflow-skills

Cria um portfólio pessoal a partir do template donotdonuts.github.io. Coleta nome, foto, currículo, URLs sociais e preferência visual do usuário, gera cards de linha do tempo/projetos e conhecimento do chatbot a partir do currículo e aplica uma paleta de cores combinante. Opcional: chatbot DeepSeek atrás de um Cloudflare Worker. Implanta estaticamente no GitHub Pages.

O que é claude-workflow-skills?

Esta skill automatiza a criação de um site de portfólio pessoal no estilo single-page a partir do template donotdonuts.github.io. Ela coleta informações do usuário (nome, foto, currículo, URLs sociais e preferência visual) e gera automaticamente a linha do tempo (experiências), cards de projetos e até mesmo um chatbot opcional alimentado pela API DeepSeek, através de um Cloudflare Worker. A skill suporta integração com GitHub Pages para deploy estático e permite personalização visual via URL de referência ou descrição textual, criando uma paleta de cores e família tipográfica personalizada. O chatbot pode ser nomeado pelo usuário, e um avatar emoji é sugerido e aprovado antes da implementação. É útil para desenvolvedores que desejam construir rapidamente um site profissional, responsivo e moderno, com funcionalidades interativas como filtro de projetos por experiência e um assistente virtual treinado com dados do currículo.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Configuração do site pessoal

Orientar um novo usuário a publicar seu próprio portfólio em https://<seu-usuario>.github.io. A arquitetura é fixa; a aparência, o conteúdo e a persona do chatbot são personalizados para cada usuário.

O que eles obtêm

  • Site estático de página única, sem bundler. O GitHub Pages serve main na raiz do repositório.
  • Hero — retrato + nome + localização em uma linha + slogan em uma linha.
  • Seção de projetos com uma linha do tempo vertical esmaecida no cabeçalho da seção (ícones de chave inglesa para trabalho, livro para educação, brilho para projetos paralelos / vibe; cada ponto mostra empresa, cargo, data e localização) e uma grade de cards de projetos no corpo — ambos gerados a partir do currículo do usuário.
  • Filtro linha do tempo ↔ cards — ao passar o mouse ou focar com teclado em um ponto da linha do tempo, os cards de projeto não relacionados são ocultados; clique para fixar o filtro (clique novamente para limpar). Apenas pontos que têm pelo menos 1 card associado se tornam interativos; os outros permanecem inertes.
  • Cards dobrados — cada card de projeto mostra apenas sua categoria + título + tags de ferramentas por padrão; o parágrafo de resumo e a linha de métricas aparecem ao passar o mouse / focar, mantendo a grade escaneável.
  • Chatbot (opcional) — um botão flutuante no canto inferior direito + painel pop-out (não é uma seção inline da página) alimentado pela API compatível com OpenAI da DeepSeek atrás de um Cloudflare Worker que guarda a chave da API. O usuário escolhe o nome do bot; o agente propõe um avatar emoji correspondente. As respostas do bot renderizam markdown. Limite de taxa em duas camadas.
  • Seção Conectar — email + URLs sociais do usuário.

Pré-requisitos

Necessário paraFerramentaInstalação
Tudogitgeralmente já instalado
TudoConta GitHub + CLI ghbrew install gh e gh auth login
Tudopython3 (visualização local)geralmente já instalado
ChatbotConta Cloudflare (nível gratuito)https://dash.cloudflare.com
ChatbotCLI wranglernpm install -g wrangler e wrangler login
ChatbotChave da API DeepSeekhttps://platform.deepseek.com/ → API keys
Ajuste de retratoNode.jsbrew install node

Passo a passo

1. Coletar entradas do usuário

Faça isso antes de tocar em qualquer arquivo. Reúna tudo de uma vez para que as etapas posteriores sejam edições automatizadas. Use AskUserQuestion para múltipla escolha e prompts diretos para texto livre.

Obtenha cada um destes do usuário:

EntradaComo perguntarExemplo
Nome de usuário no GitHubdiretojane (o repositório será jane.github.io)
Nome de exibiçãodiretoJane Doe ou Jane "JD" Doe
Frase de localizaçãodireto, curtoRegião metropolitana de NY, Remoto, Tóquio
Slogandireto, uma fraseConstruo sistemas de ML e amo entregar.
Currículocolar texto ou caminho para arquivocurrículo completo — usado para preencher a linha do tempo, cards de projetos, conhecimento do chatbot
Fotocaminho para uma imagem quadrada no disco/Users/jane/Desktop/headshot.jpg. O usuário pode colocá-la na raiz do repositório como raw.jpg após clonar.
URLs sociaisdireto, cada um opcionalPerfil LinkedIn / GitHub / Medium / email pessoal
Chatbot?AskUserQuestionsim / não
Nome do chatbot (se sim)diretoPot, Nova, Echo, etc.
Estilo visualAskUserQuestion"Cole uma URL de que gosto" OU "Descreva em palavras"

Após coletar o nome do chatbot, proponha 2–3 avatares emoji que combinem tematicamente e deixe o usuário escolher. Exemplos:

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

Se nada óbvio se encaixar, ofereça neutros: 🤖, 💬, 🪄. Armazene o emoji + nome escolhidos — você os escreverá no código mais tarde.

2. Criar o repositório no GitHub

gh repo create <usuario>.github.io --public --description "Site pessoal"

Sites de usuário do GitHub Pages DEVEM estar em <usuario>.github.io.

3. Clonar o template

git clone https://github.com/donotdonuts/donotdonuts.github.io meu-site
cd meu-site
rm -rf .git
git init -b main
git remote add origin https://github.com/<usuario>/<usuario>.github.io.git

4. Escolher um estilo visual

O template padrão tem uma estética creme + IBM Plex Mono. Sobrescreva com base na resposta do usuário da Etapa 1.

4a. Se o usuário forneceu uma URL

Extraia o CSS da página e extraia tokens:

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

# fonte realmente aplicada ao body
grep -oE 'body[^{]{0,30}\{[^}]+\}' /tmp/ref-1.css | head -5
# todas as definições de propriedades personalizadas CSS
grep -oE -- '--[a-zA-Z-]+:[^;}]+' /tmp/ref-1.css | sort -u | head -60

Procure por: hex do fundo, hex do texto principal, hex da borda, hex de destaque, font-family aplicada ao body, URLs @font-face.

4b. Se o usuário forneceu uma descrição

Traduza a descrição em tokens concretos. Heurísticas:

PalavrasImplicação
"minimalista", "editorial", "papel"Fundo creme / off-white, tinta escura, divisores finos
"escuro", "terminal", "IDE"Fundo quase preto (#0f1115), tinta clara, bordas cinza sutis
"quente", "analógico"Creme levemente amarelado (#faf5e8), tinta marrom-escura
"brutalista"Branco puro ou preto puro, bordas sólidas de 2px+
"tech", "dados"Monoespaçada (IBM Plex Mono, JetBrains Mono), cinzas frios
"revista", "editorial"Serifada (EB Garamond, Fraunces), entrelinhas generosas
"divertido"Um destaque saturado, o resto neutro

4c. Propor + aplicar

Compile 13 tokens + uma pilha de fontes. Mostre a paleta proposta como um bloco de código e obtenha aprovação antes de editar arquivos.

:root {
  --bg:             <hex>;   /* fundo da página */
  --bg-soft:        <hex>;   /* sub-painéis — geralmente --bg misturado ~3% com --ink */
  --bg-hover:       <hex>;   /* hover de tag/chip */
  --card-bg:        <hex>;   /* preenchimento opaco do card (branco se tema claro) */
  --ink:            <hex>;   /* texto primário */
  --ink-soft:       <hex>;   /* ~80% de --ink */
  --ink-mute:       <hex>;   /* ~60% */
  --ink-faint:      <hex>;   /* ~40% */
  --border:         <hex>;   /* divisores sutis */
  --border-strong:  <hex>;   /* divisores estruturais */
  --up:             <hex>;   /* métricas positivas (esverdeado por padrão) */
  --down:           <hex>;   /* métricas negativas (avermelhado por padrão) */
  --accent-ink:     <hex>;   /* links */
  --font-mono:      "<Família>", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

Em seguida:

  1. Abra css/styles.css, encontre o bloco :root, substitua os valores.
  2. Abra index.html, atualize o <link> do Google Fonts no <head> com a nova família de fontes + pesos.

5. Gerar conteúdo a partir do currículo + entradas

Use o currículo + outras entradas da Etapa 1 para preencher index.html:

  1. <head> — <title> = <Nome de Exibição> — <primeiro-cargo-do-currículo>; <meta name="description"> a partir do slogan.

  2. Hero:

    • <h1 class="hero-title"> ← nome de exibição
    • <p class="hero-location"> ← frase de localização
    • <p class="hero-tagline"> ← slogan
  3. Linha do tempo — analise o currículo em pontos. Um <li class="tl-stop"> por cargo, por diploma, E por categoria de projeto paralelo contínuo que o usuário queira destacar. Ordem presente → mais antigo (de cima para baixo no DOM). Escolha um slug curto data-experience para cada um (ex.: marte, vibe, coach, gatech) — é o que o filtro usa para associar pontos a cards. Adicione tabindex="0" apenas em pontos que tenham ≥1 card de projeto associado (outros permanecem inertes).

    <li class="tl-stop tl-stop-work" data-experience="<slug>" tabindex="0">
      <!-- tl-stop-work | tl-stop-edu | tl-stop-vibe   (escolha um) -->
      <svg class="tl-icon tl-icon-work" aria-hidden="true">
        <use href="#icon-wrench"/>       <!-- #icon-wrench | #icon-book | #icon-sparkle -->
      </svg>
      <div class="tl-info">
        <strong>Empresa / Escola</strong>
        <span>Cargo / Diploma</span>
        <em>Início — Fim</em>
        <i class="tl-loc">Cidade, Estado</i>
      </div>
    </li>
    

    Remova tabindex="0" de pontos de educação / cargos antigos que não tenham cards de projeto associados — js/main.js detecta isso automaticamente no carregamento e os deixa não interativos.

  4. Projetos — ~seis blocos <article class="project-card">, gerados a partir de projetos/realizações notáveis no currículo. Cada card DEVE carregar um slug data-experience correspondente ao ponto de origem, ou não participará do filtro:

    <article class="project-card" data-experience="<slug>">
      <header class="project-head">
        <span class="project-tag">Categoria</span>
        <h3>Título do Projeto</h3>
      </header>
      <p>Resumo de 1–2 frases extraído do tópico do currículo.</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>Ferramenta</li><li>Ferramenta</li></ul>
    </article>
    

    Use <dd class="up"> / <dd class="down"> para colorir métricas. Os cards são renderizados dobrados por padrão — apenas a tag, título e tags de ferramentas são visíveis até que o hover / foco dentro revele o resumo + métricas. Mantenha os resumos concisos; eles só existem para recompensar um hover.

  5. Saudação do chat — a mensagem de abertura do bot é HTML inline dentro de #chat-panel em index.html (dentro do <div class="chat-log"> do painel), para que seja renderizada instantaneamente quando o usuário abrir o pop-out pela primeira vez. Reescreva usando o nome do bot escolhido + avatar emoji. Formato:

    <div class="chat-msg chat-msg-bot">
      <span class="chat-avatar" aria-label="<Nome do Bot>">EMOJI</span>
      <div class="chat-bubble">
        <p>Olá, sou <strong><Nome do Bot></strong> — assistente de IA de <Nome de Exibição>, <verbado> a partir <do/dele/dela> currículo.</p>
        <p>Pergunte sobre:</p>
        <ul>
          <li>Empresas / cargos</li>
          <li>Métodos / abordagens</li>
          <li>Projetos / habilidades / educação</li>
        </ul>
        <p>O que gostaria de saber?</p>
      </div>
    </div>
    
  6. Conectar — email + cada URL social fornecida como um <li> em .connect-list. Exclua linhas para qualquer plataforma não fornecida.

6. Adicionar o retrato

Pergunte onde está a foto. Copie para a raiz do repositório como raw.jpg, então redimensione:

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

Se o fundo da foto não combinar com o novo --bg, mude com o script incluído:

cd /tmp && rm -rf img-fix && mkdir img-fix && cd img-fix
npm init -y > /dev/null
npm install [email protected] --silent
node <caminho-desta-skill>/scripts/shift-portrait.js \
  /caminho/para/meu-site/raw.jpg \
  /caminho/para/meu-site/assets/portrait.jpg \
  "#<seu-hex-bg>"

Padrão é #fbf7eb se o terceiro argumento for omitido. raw.jpg está no .gitignore.

7. Configurar o chatbot (pule se o usuário disse não)

7a. Worker

cd worker
wrangler login
wrangler secret put DEEPSEEK_API_KEY

worker/wrangler.toml:

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

worker/worker.js → SYSTEM_PROMPT — reescreva a partir do currículo do usuário. Mantenha a estrutura de seções (Sobre / Cargo atual / Cargos anteriores / Educação / Caixa de ferramentas). Também reescreva a frase de persona de abertura usando o nome + avatar do bot:

const SYSTEM_PROMPT = `Você é "<Nome do Bot>" <EMOJI> — um assistente de IA amigável e conciso incorporado no site pessoal de <Nome de Exibição>. ...`;

Implante:

wrangler deploy

7b. Cliente

js/config.js:

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

js/chatbot.js — atualize as constantes no topo:

const AVATAR = "<EMOJI>";
const AVATAR_LABEL = "<Nome do Bot>";

8. Visualizar + enviar

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

Navegue por todas as seções. Teste o chat. Redimensione para largura de celular. Então:

git add .
git commit -m "inicial: site pessoal"
git push -u origin main

Publicado em https://<usuario>.github.io/ em aproximadamente 60 segundos.

Arquitetura do template (não altere)

Layout de seções

Cada seção usa .section-grid: 280px 1fr. A coluna de 280px cabe o rótulo mais longo da linha do tempo. Aperte para 240px se todos os rótulos forem curtos, alargue para 320px se longos.

Linha do tempo

  • Vive dentro do section-head da seção Projetos, logo abaixo do título, em opacity: 0.45. Hover, foco ou um filtro ativo eleva para 0.95.
  • Ordem no DOM = ordem visual de cima para baixo. Presente → mais antigo. NÃO proporcional ao tempo — distribuído uniformemente via flex gap.
  • Três tipos de ícone prontos: #icon-wrench (trabalho, .tl-stop-work), #icon-book (educação, .tl-stop-edu), #icon-sparkle (vibe / projeto paralelo, .tl-stop-vibe). Todas as três definições <symbol> estão no sprite SVG logo após <header>. Para adicionar uma nova categoria de ícone:
    1. Adicione um <symbol id="icon-foo"> com seu caminho SVG
    2. Adicione .tl-icon-foo { color: var(--ink-mute); }
    3. Referencie com <svg class="tl-icon tl-icon-foo"><use href="#icon-foo"/></svg>
  • Cada ponto carrega data-experience="<slug>"; pontos cujo slug corresponda a pelo menos um card de projeto também recebem tabindex="0" para que js/main.js possa torná-los interativos para filtro.

Filtro de projetos (clique + hover)

Conduzido inteiramente por js/main.js, zero configuração — ele escaneia o DOM no carregamento e conecta handlers apenas onde se aplicam.

  • No carregamento, cada ponto cujo slug data-experience esteja presente em pelo menos um .project-card recebe .tl-stop-has-projects + role="button" + aria-pressed="false". Pontos sem cards associados permanecem inertes.
  • Hover / foco em um ponto interativo → filtro temporário: cards não correspondentes recebem .is-dim (a grade adiciona .is-filtering, que o CSS traduz em display: none nos cards escurecidos — eles são removidos do layout, não apenas esmaecidos).
  • Clique (ou Enter / Space) → trava: o ponto recebe .is-locked, opacidade total, ícone colorido com a tinta, nome da empresa sublinhado. Clique no mesmo ponto novamente para limpar; clique em outro para trocar.
  • Enquanto travado, passar o mouse em um ponto diferente pré-visualiza seus cards; mouseleave na barra (ou focusout dela) restaura o filtro travado.

Cards de projeto

  • Cada .project-card leva um data-experience que vincula a um ponto da linha do tempo. Agora também leva data-tools com uma lista separada por vírgulas de ferramentas (ex.: data-tools="Python,PyTorch,Spark") para opções futuras de filtro por ferramenta. O js/main.js ainda não usa isso, mas o dado está no DOM.
  • Largura fixa de 220px (mais gap: 24px), altura dinâmica por conteúdo. Quebram para 1 coluna em mobile.
  • Tags de ferramentas em .tag-list.small são agrupadas juntas por padrão; um hover/foco dentro do card revela o resumo e as métricas.

Chatbot

  • Painel pop-out fixo no canto inferior direito com um botão de alternância. O painel é <div id="chat-panel">, inicialmente oculto (display: none), alternado via js/chatbot.js.
  • chatWorkerUrl em js/config.js aponta para o Worker Cloudflare implantado. O Worker retorna marcação de streaming (SSE-like).
  • A primeira mensagem visível no <div class="chat-log"> é a saudação inline; após o usuário enviar uma mensagem, as respostas são anexadas via JavaScript. Cada mensagem consiste em um span.chat-avatar + div.chat-bubble.
  • O bot não precisa de entrada além das mensagens; o usuário também pode clicar em perguntas sugeridas.
  • O tema de cores do painel de chat corresponde a --bg / --ink / --accent-ink da página — não há CSS separado para o chatbot.

Constantes e configuração

ArquivoO que ajustar
css/styles.css, bloco :root13 tokens CSS + pilha de fontes
index.html <title> + <meta>Título da página e descrição
index.html HeroNome, localização, slogan
index.html <ul class="connect-list">Email + URLs sociais
index.html <div class="chat-log">Saudação inline do bot (emoji + nome)
index.html <div class="project-card">Conteúdo do projeto (3–6 cards)
index.html <li class="tl-stop">Pontos da linha do tempo (todos os cargos/diplomas)
js/chatbot.jsAVATAR + AVATAR_LABEL
js/config.jsSITE_CONFIG.chatWorkerUrl
worker/worker.jsSYSTEM_PROMPT
worker/wrangler.tomlALLOWED_ORIGIN (adicionar o domínio do usuário)

Habilidades Relacionadas