Communitygithub.com

Gyschuaner/da-ideia-ao-site-pessoal

Use esta habilidade quando o usuário quiser criar, implementar, redesenhar ou atualizar um site pessoal sem dependências: site pessoal, blog, página inicial, portfólio, página de pesquisa ou jardim digital usando apenas HTML, CSS e JavaScript puro. Use-a após uma direção de tema ter sido escolhida, ou quando o usuário quiser um site sem framework que possa ser aberto diretamente no navegador e implantado como arquivos estáticos.

O que é da-ideia-ao-site-pessoal?

Esta habilidade guia a criação ou reformulação de um site pessoal estático, utilizando exclusivamente HTML, CSS e JavaScript vanilla, sem frameworks, pacotes ou dependências de runtime. Ela é ideal para quem deseja um site simples, inspecionável e implantável como arquivos estáticos, funcionando tanto ao abrir o arquivo `index.html` diretamente no navegador quanto ao ser servido via HTTP local ou em hospedagem estática. A habilidade suporta plataformas como Claude Code, Cursor e Codex, e seu fluxo de trabalho envolve esclarecer o propósito do site, construir um layout compartilhado (cabeçalho, navegação, rodapé), implementar páginas representativas (início, sobre, blog, projetos) e gerar um guia de edição (`EDITING.md`). As regras incluem o uso de caminhos relativos para compatibilidade, armazenamento de dados repetidos em JSON ou objetos JavaScript locais, e a tradução de referências complexas (como componentes React) para equivalentes estáticos simples, garantindo que o site funcione em múltiplos ambientes sem perda de funcionalidade.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Gyschuaner/from-idea-to-personal-site/tree/HEAD/.agents/skills/make-personal-site

Perguntar na sua IA favorita

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

Documentação

Criar Site Pessoal

Objetivo

Criar ou redesenhar um site pessoal como arquivos estáticos simples: HTML, CSS e opcionalmente JavaScript vanilla.

Esta habilidade é a etapa de implementação após uma direção visual ter sido escolhida. Ela transforma uma recomendação de tema, perfil de usuário, anotações, posts de exemplo, descrições de projetos ou uma pasta de site estático existente em um site pessoal funcional.

Promessa central:

  • Sem framework.
  • Sem etapa de build.
  • Sem instalação de pacotes.
  • Sem dependência de runtime.
  • Abrir index.html diretamente para visualização manual.
  • Usar links e ativos relativos à página para que abertura direta de arquivo, HTTP local e hospedagem estática funcionem.
  • Implantar a pasta em hospedagem estática.

Para QA automatizado no navegador, sirva a pasta estática por HTTP local em vez de abrir URLs file://.

Contrato

Entradas:

  • Direção de tema, materiais de perfil do usuário, necessidades de página, conteúdo de exemplo ou uma pasta estática existente.
  • Referências opcionais que devem guiar o estilo sem exigir uma réplica de alta fidelidade.
  • Pasta de saída desejada e restrições estáticas.

Saídas:

  • Uma pasta de site estático simples com HTML, CSS, JavaScript vanilla opcional, ativos locais e tipos de página representativos.
  • EDITING.md para edições futuras quando um novo site ou reformulação material for criada.
  • Instruções de visualização local e resumo de validação.

Limites:

  • Não recriar fielmente um site alvo específico; usar copy-website-style.
  • Não importar grandes arquivos de escrita; usar add-blog-posts.
  • Não publicar ou configurar hospedagem; usar publish-static-site.
  • Não introduzir frameworks, instalações de pacotes, backends, CMS, autenticação ou bancos de dados, a menos que o usuário peça explicitamente.

Portão de sucesso:

  • Os tipos de página necessários existem e a navegação aponta para caminhos relativos reais.
  • O site funciona como arquivos estáticos simples sem etapa de build.
  • O código-fonte é legível em UTF-8, os placeholders são claros e review-static-site pode passar ou relatar apenas limitações aceitas.

Se o portão falhar:

  • Corrigir tipos de página ausentes, caminhos, ativos, codificação, placeholders ou problemas de navegador dentro desta habilidade.
  • Usar personalize-site quando a falha for identidade/conteúdo do usuário ausente.
  • Usar review-static-site novamente após as correções.

Pipeline Curto

Siga este pipeline para trabalho original de site pessoal:

  1. Esclarecer o propósito do site, direção do tema, conteúdo disponível e escopo da página.
  2. Decidir o mapa de páginas estáticas e a estratégia de placeholders antes de codificar.
  3. Construir primeiro a estrutura compartilhada: cabeçalho, navegação, layout principal, rodapé, variáveis CSS globais e interações compartilhadas.
  4. Implementar a página inicial e cada tipo de página solicitado ou implícito.
  5. Usar o conteúdo do usuário ou placeholders claramente substituíveis; não inventar identidade pessoal detalhada.
  6. Adicionar um guia de edição para futuras edições do modelo/usuário.
  7. Verificar a compatibilidade de caminhos de abertura direta com links e ativos relativos.
  8. Validar localmente via HTTP em um navegador real.
  9. Verificar links, ativos, tipos de página e legibilidade do código-fonte UTF-8 antes da entrega final.

Quando Usar

Use esta habilidade quando o usuário:

  • Quiser um site pessoal, blog, página inicial, portfólio, página de pesquisa ou site estático simples em HTML/CSS/JS.
  • Pedir para implementar uma direção de tema produzida por search-blog-theme.
  • Quiser um site simples sem framework, fácil de inspecionar, editar e implantar.
  • Quiser redesenhar um site estático existente mantendo-o livre de dependências.
  • Fornecer referências visuais soltas, mas não exigir uma réplica de alta fidelidade.

Não Usar Quando

Não use esta habilidade quando:

  • O usuário apenas quiser pesquisar temas ou comparar referências visuais. Usar search-blog-theme.
  • O usuário quiser recriar fielmente a aparência, layout, movimento ou sensação de interação de um site específico. Usar copy-website-style.
  • O usuário quiser migrar muitos posts, converter notas do Obsidian, reparar frontmatter ou mover grandes arquivos de conteúdo. Usar add-blog-posts.
  • O usuário quiser apenas ajuda com implantação, DNS, GitHub Pages, Cloudflare Pages, Cloudflare Pages Direct Upload, Netlify ou Vercel. Usar publish-static-site.
  • O usuário pedir explicitamente por um projeto de framework como Next.js, Astro, Hugo, Jekyll, Quartz ou React.
  • O usuário pedir por um backend, banco de dados, autenticação, CMS, sistema de comentários ou comportamento dinâmico de servidor.

Entradas

Use o que o usuário fornecer. Não bloquear se alguns detalhes estiverem faltando.

Entradas úteis incluem:

  • Direção de tema: arquivo de código privado, dashboard de registro de pesquisa, jardim digital, portfólio bento, caderno de campo, sistema operacional pessoal, etc.
  • Perfil do usuário: nome, breve biografia, função, localização, links sociais, avatar, currículo, publicações, projetos.
  • Necessidades de página: início, sobre, blog, projetos, notas, publicações, contato.
  • Conteúdo de exemplo: 1-3 posts, descrições de projetos, trechos de Markdown, páginas HTML antigas.
  • Pasta de site existente: arquivos HTML/CSS/JS atuais para preservar ou refatorar.
  • Referências soltas: v0, Figma, temas do GitHub, templates de framework, capturas de tela ou referências de clima visual.

Regra de Referência

Referências podem vir de qualquer stack. Trate-as como referências visuais e estruturais, não como escolhas de implementação, a menos que o usuário peça explicitamente para usar aquele framework.

Para um site estático simples, traduza referências assim:

  • Componentes React, Next ou Astro -> seções HTML repetidas com classes CSS reutilizáveis.
  • Classes utilitárias do Tailwind -> regras CSS normais em assets/style.css.
  • Rotas de framework -> arquivos .html vinculados.
  • Coleções de conteúdo ou dados de CMS -> listas HTML estáticas ou pequenos arquivos JSON.
  • Configuração de tema -> propriedades personalizadas CSS.
  • Interações simples -> JavaScript vanilla apenas quando útil.

Se o usuário quiser combinar fielmente um site específico, delegar para copy-website-style em vez de tratar como referência solta.

Estrutura de Site Padrão

Para um novo site, prefira esta estrutura, a menos que o usuário peça o contrário:

site/
  index.html
  EDITING.md
  about.html
  blog.html
  projects.html
  posts/
    first-post.html
  assets/
    style.css
    script.js
    images/
  data/
    posts.json
    profile.json

Para um site existente, preserve a estrutura atual do usuário quando prático. Não renomeie ou reorganize grandes partes do site, a menos que melhore claramente o trabalho solicitado.

Expectativas de Página

Crie apenas as páginas necessárias para a solicitação do usuário. Para um starter de site pessoal completo, inclua:

  • Início: identidade, introdução curta, área de herói específica do tema, posts recentes, projetos selecionados.
  • Sobre: biografia, interesses, habilidades, contato, links sociais, CV/publicações opcionais.
  • Índice do blog: lista de posts com título, data, tags e resumo.
  • Página de post: layout de artigo legível com título, data, tags, conteúdo e navegação de volta ao índice do blog.
  • Projetos: cards ou linhas de projetos com descrição, stack, links e resultado.

Mantenha a primeira tela útil. Não crie uma landing page de marketing quando o usuário pediu um site pessoal ou blog.

Para um starter completo de site pessoal ou blog, não pare em uma única página inicial. Crie tipos de página representativos funcionais, mesmo quando o conteúdo for apenas placeholder:

  • Pelo menos uma página de artigo/detalhe para um blog.
  • Uma página de lista ou arquivo quando posts, notas, projetos ou publicações fizerem parte do site.
  • Uma página de perfil/sobre quando a página inicial vincular a identidade ou detalhes de formação.
  • Qualquer página especial implícita pelo conceito escolhido, como notas, links, jardim, now, uses, publicações ou experimentos.

Para grandes coleções de conteúdo futuro, crie a estrutura e algumas entradas placeholder representativas em vez de inventar um arquivo completo.

Regra de Compatibilidade de Caminhos

Os sites estáticos gerados devem funcionar quando o usuário abrir index.html diretamente, quando servidos por HTTP local e quando implantados em hosts estáticos comuns.

Regras padrão:

  • Usar caminhos relativos à página para todos os links e ativos locais do site.
  • Das páginas raiz, vincular CSS/JS/imagens como assets/style.css, assets/script.js, assets/images/avatar.png e páginas como about.html ou posts/example.html.
  • De páginas aninhadas como posts/example.html, vincular ativos compartilhados como ../assets/style.css e páginas raiz como ../blog.html ou ../index.html.
  • Não usar caminhos absolutos de raiz do site como /assets/style.css, /assets/script.js, /posts/example.html, /data/posts.json, /images/foo.png ou /, a menos que o usuário aceite explicitamente o comportamento apenas de raiz do servidor.
  • Aplicar a mesma regra para url(...) em CSS, favicons, imagens Open Graph, imagens de capa, fontes, ativos de terceiros KaTeX/math, links RSS/sitemap e URLs geradas por JavaScript.
  • Ao mover ou adicionar uma página, recalcular caminhos com base na profundidade da pasta dessa página, em vez de copiar links de uma página raiz.

Evitar suposições apenas de servidor:

  • Não depender de fetch("data/posts.json") ou outras buscas de arquivo local para navegação principal, listas de posts ou conteúdo da página inicial, se a visualização de abertura direta fizer parte da promessa.
  • Se dados repetidos forem úteis, renderizar o conteúdo essencial diretamente em HTML ou armazenar dados em um objeto JavaScript local carregado com um <script src="assets/script.js"> relativo.
  • Melhorias opcionais podem usar arquivos de dados apenas quando a página ainda ler e navegar corretamente sem aquela busca.

Regras de Estilo

Deixe o tema selecionado guiar a linguagem visual, mas mantenha o site legível e sustentável.

  • Colocar a estilização de todo o site em assets/style.css.
  • Usar propriedades personalizadas CSS para cores, espaçamento, bordas e escolhas tipográficas.
  • Usar HTML semântico quando possível: header, nav, main, article, section, footer.
  • Usar regras de layout responsivo para que as páginas funcionem em dispositivos móveis e desktop.
  • Tornar as páginas de artigo mais calmas do que a página inicial, se o tema for visualmente intenso.
  • Preferir fontes do sistema, a menos que o usuário peça uma fonte específica ou o tema exija uma.
  • Não depender de ativos remotos, a menos que o usuário os forneça ou eles sejam claramente aceitáveis.
  • Não deixar efeitos decorativos bloquearem a leitura, navegação ou acessibilidade.

Regras de Interação

Usar JavaScript vanilla apenas quando agregar valor claro.

Bons usos:

  • Alternância de navegação móvel.
  • Alternância de tema.
  • Filtragem leve de tags ou posts.
  • Pequenos efeitos progressivos que não afetam a leitura principal.

Evitar:

  • Frameworks de animação pesados.
  • Decoração com uso intenso de Canvas, a menos que o usuário peça explicitamente.
  • Efeitos que exigem um servidor de desenvolvimento ou instalação de pacote.
  • Cintilação contínua, glitching agressivo ou efeitos de rolagem que prejudicam a leitura.

Respeitar prefers-reduced-motion para temas animados.

Regra de Simplificação Estática

Quando uma referência solta tiver recursos complexos ou dependentes de framework, traduzi-los em equivalentes estáticos mais simples:

  • Globo 3D -> mapa de tópicos, painel de status, constelação de projetos ou bloco visual estático.
  • Grid bento animado -> grid CSS responsivo com estados de hover sutis.
  • Simulador de terminal -> navegação temática e conteúdo em estilo de log, não uma linha de comando falsa, a menos que útil.
  • Grafo de conhecimento -> tags, posts relacionados, índice de tópicos ou links curados manualmente.
  • Busca dinâmica -> entrada de filtro simples, páginas de tag estáticas ou nenhuma busca para a primeira versão.
  • Posts orientados por CMS -> posts/*.html mais data/posts.json.

Preferir uma versão estática limpa que capture a sensação desejada pelo usuário em vez de uma cópia superdimensionada da referência.

Regra de Site Existente

Ao modificar um site existente:

  • Inspecionar a estrutura de arquivos atual antes de editar.
  • Preservar o conteúdo do usuário e arquivos não relacionados.
  • Manter as alterações limitadas às páginas e ativos solicitados.
  • Reutilizar convenções visuais existentes quando já funcionarem.
  • Evitar substituir o site inteiro, a menos que o usuário peça uma reformulação completa.
  • Se o site já tiver style.css ou script.js, estendê-los com cuidado em vez de criar duplicatas conflitantes.

Regra de Conteúdo

Para pequenas quantidades de conteúdo, escrever HTML estático diretamente.

Para conteúdo repetido como posts ou projetos, usar:

  • HTML estático repetido quando a lista for curta.
  • Um objeto de dados JavaScript local mais renderização JavaScript vanilla quando melhorar a capacidade de manutenção.
  • Um pequeno arquivo JSON apenas quando o site puder exigir HTTP local/hospedagem estática para esse recurso, e a página principal ainda funcionar sem ele.

Não inventar fatos pessoais detalhados. Usar placeholders claramente quando os dados do usuário estiverem ausentes.

Manter os placeholders fáceis de encontrar e substituir. Preferir armazenar conteúdo repetido em um local claramente nomeado, como data/*.json, um bloco de dados documentado em assets/script.js ou uma seção HTML repetida com nomes de classe estáveis.

Marcar conteúdo apenas placeholder, posts de demonstração, projetos de exemplo e links mock claramente nos arquivos ou no EDITING.md para que o usuário ou um modelo futuro possa substituí-los antes da publicação.

Regra do Guia de Edição

Ao criar um novo site ou reformular materialmente um existente, incluir EDITING.md na pasta de saída.

EDITING.md é principalmente para um modelo ou agente futuro que modificará o site gerado posteriormente. Mantê-lo conciso, mas concreto. Explicar:

  • Hierarquia de pastas e para que serve cada arquivo/pasta.
  • Formatos de arquivo usados pelo site: HTML, CSS, JS, blocos JSON/dados e imagens.
  • Mapa de páginas: qual arquivo gerado é a página inicial, sobre/perfil, blog/lista, artigo/detalhe, projetos, notas, links ou outros tipos de página.
  • Regiões de layout compartilhado: cabeçalho, navegação, navegação móvel, conteúdo principal, rodapé, barras laterais, sobreposições ou controles de tema.
  • Onde cada região principal da página inicial está em index.html, usando nomes de seção/classe próximos.
  • Onde cada template de subpágina está e como os links internos se conectam a ele.
  • Onde o conteúdo repetido é armazenado e seu formato esperado de objeto/marcação.
  • Como alterar título do site, tagline, avatar/logo, navegação, posts em destaque, listas de projetos, listas de links, imagens, cores e variáveis de tema.
  • Qual conteúdo é apenas placeholder e deve ser substituído antes da publicação.

Regra de Integridade de Codificação

Os arquivos fonte gerados devem ser UTF-8 válidos e legíveis por humanos em forma de código-fonte, não apenas com aparência correta em capturas de tela do navegador.

Para páginas ou guias de edição contendo texto em chinês, japonês, coreano, latim acentuado ou outro conteúdo não-ASCII:

  • Incluir <meta charset="utf-8"> nos arquivos HTML.
  • Escrever os arquivos como UTF-8.
  • Verificar a legibilidade do código-fonte com um leitor compatível com UTF-8 antes da entrega final.

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

Gyschuaner/from-idea-to-personal-site

Use this skill to add, import, or migrate one or more blog posts, notes, essays, articles, Markdown files, Word documents, or rich-content writing folders into an existing static personal website or blog while preserving the site's current article style, content structure, navigation, indexes, archives, tags, assets, math, links, tables, code blocks, embeds, and homepage entry points. Use it for pasted posts, local Markdown files, Obsidian notes, .docx drafts, old static HTML posts, exported blog content, or small-to-medium batches of posts after a site has already been created.

Gyschuaner/from-idea-to-personal-site

Route and coordinate the personal website skill suite for creating, recreating, personalizing, adding content to, validating, editing, or preparing a static personal website or blog. Use when the agent needs to choose between theme search, style reference research, original build, website style recreation, personalization, post import, review, local edits, or publishing preparation, or when the user asks what step comes next in an existing site-building workflow.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to recreate, copy, clone, remix, or closely match the look, layout, motion, or interaction feel of a specific website, URL, screenshot, or template using plain HTML, CSS, and JavaScript. Use it to inspect public source as research, rewrite original code, avoid direct reuse of protected assets, and validate the result in a browser.

Gyschuaner/from-idea-to-personal-site

Use this skill to make focused, small-scope edits to a generated static website, personal blog, portfolio, digital garden, or style recreation. Use it when the user wants to adjust one page section, component, visual detail, copy block, responsive issue, or lightweight interaction without rebuilding the whole site. Typical requests include changing a hero block, card layout, sidebar, footer, button, mobile menu, spacing, color, typography, animation intensity, or a small piece of page copy.

Gyschuaner/from-idea-to-personal-site

Use this skill after a personal website or blog style direction is roughly known and before building an original site. It searches for real websites, templates, portfolios, blogs, screenshots, or design examples that match the chosen direction, inspects them with browser or screenshot tools when available, and turns the findings into a practical design reference brief for make-personal-site. Use it for requests like finding references for a natural technical blog, cozy research homepage, brutalist portfolio, digital garden, minimal notes site, or any named visual direction that still needs concrete examples.

Gyschuaner/from-idea-to-personal-site

Run the complete idea-to-personal-website or blog workflow. Use when the user wants a one-click or end-to-end pipeline from a vague idea, reference URL, template, personal materials, style direction, or writing drafts to concrete style references, a validated static personal site, and optionally a live deployment on GitHub Pages, Cloudflare Pages, Netlify, or Vercel.

Gyschuaner/from-idea-to-personal-site

Use this skill to turn a generated static personal website, blog, portfolio, digital garden, or style recreation into the user's own site by replacing placeholder identity, profile copy, links, projects, featured items, contact details, metadata, and demo page content. Use it after make-personal-site or copy-website-style, or when a user provides an existing static site folder and personal materials such as a bio, resume, README, GitHub profile, old homepage, Markdown notes, or social links.

Gyschuaner/from-idea-to-personal-site

Publish, deploy, or prepare a finished static personal website, blog, portfolio, or style recreation for hosting on GitHub Pages, Cloudflare Pages, Netlify, or Vercel. Use when the user asks to publish a static site, configure deployment settings, add GitHub Pages workflows, choose a static hosting platform, prepare a repo for Pages/Cloudflare/Netlify/Vercel, verify a deployed URL, or explain how to deploy a site folder such as site/, dist/, out/, public/, or docs/.

Gyschuaner/from-idea-to-personal-site

Use this skill to inspect, validate, QA, or sanity-check a generated static website, personal blog, portfolio, digital garden, or style recreation before handoff or publishing. Use it for local folders such as site/, dist/, out/, or public/ to check broken links, missing page types, browser rendering, console errors, desktop/mobile screenshots, UTF-8 source readability, mojibake, relative asset paths, direct-open/file compatibility, placeholder content, and leftover copied source-specific text.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to find, compare, choose, or adapt a visual theme for a personal blog, personal homepage, portfolio, research homepage, digital garden, or static website. Use it to turn references from v0, Figma, GitHub themes, existing websites, screenshots, keywords, or natural-language taste preferences into natural, practical theme recommendations.

Habilidades Relacionadas