Communitygithub.com

Gyschuaner/from-idea-to-personal-site

Use esta habilidade para transformar um site estático pessoal gerado (blog, portfólio, jardim digital ou recriação de estilo) no site do usuário, substituindo identidade fictícia, texto de perfil, links, projetos, itens em destaque, detalhes de contato, metadados e conteúdo de páginas de demonstração. Use-a após make-personal-site ou copy-website-style, ou quando o usuário fornecer uma pasta de site estático existente e materiais pessoais como biografia, currículo, README, perfil do GitHub, página inicial antiga, notas em Markdown ou links de redes sociais.

O que é from-idea-to-personal-site?

Esta habilidade (skill) é projetada para o fluxo de trabalho de personalização de sites estáticos, atuando após a geração inicial de um site modelo (usando ferramentas como `make-personal-site` ou `copy-website-style`) ou quando o usuário já possui uma pasta de site estático. Seu objetivo principal é substituir todo o conteúdo de marcador de posição e identidade de demonstração por informações reais do usuário, como nome, biografia, links de redes sociais, projetos em destaque, avatar e detalhes de contato. A habilidade realiza um inventário completo de arquivos HTML, dados JSON e blocos de JavaScript para localizar e substituir textos como "your name", "[email protected]" e "lorem ipsum", garantindo consistência em todas as páginas. Ela suporta agentes como Claude Code, Cursor e Codex, utilizando ferramentas interativas de navegador (como `@browser` no Codex) para validação visual, com fallback para Playwright ou auditorias de código. A habilidade respeita limites importantes: não inventa fatos pessoais, não altera o design ou tema, não migra arquivos grandes e mantém caminhos de arquivos relativos para compatibilidade com abertura direta de arquivos locais. Ao final, ela gera ou atualiza o arquivo `EDITING.md` para documentar todas as alterações e placeholders remanescentes, e sugere a execução de `review-static-site` para validação final.

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

Perguntar na sua IA favorita

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

Documentação

Personalizar Site

Objetivo

Personalizar um site estático já gerado para que ele pareça o site do próprio usuário, em vez de um modelo, demonstração ou referência copiada.

Esta habilidade edita conteúdo e metadados. Ela não escolhe um tema, redesenha o layout, recria um site de referência, migra um grande arquivo de artigos, publica o site ou converte o projeto para outro framework.

Contrato

Entradas:

  • Pasta de site estático gerado existente, EDITING.md, mapa de páginas ou notas de transição.
  • Identidade/conteúdo fornecidos pelo usuário: biografia, currículo, README do GitHub, página inicial antiga, links de redes sociais, projetos, avatar/logo, detalhes de contato ou substituições específicas.
  • Arquivos de dados existentes, blocos de dados JavaScript, metadados e conteúdo de marcador de posição/site de origem a serem substituídos.

Saídas:

  • Conteúdo visível personalizado, metadados, links, imagens e campos de identidade em nível de código-fonte.
  • Resíduos de modelo/demonstração/site de origem removidos ou substituídos.
  • EDITING.md atualizado descrevendo campos preenchidos, placeholders remanescentes e locais de conteúdo.

Limites:

  • Não escolha um novo tema, redesenhe o layout, recrie um novo site de referência, importe um grande arquivo de textos, publique ou converta frameworks.
  • Não invente fatos pessoais específicos, empregadores, escolas, prêmios, datas, locais ou métricas.
  • Não cole dados privados do usuário de volta no relatório final desnecessariamente.

Portão de sucesso:

  • A identidade/conteúdo fornecidos pelo usuário aparecem nos locais corretos visíveis no navegador.
  • Placeholders importantes e identidade do site de origem foram removidos ou intencionalmente documentados.
  • Links internos/ativos alterados permanecem relativos à página e válidos.
  • review-static-site pode ser executado ou apenas relatar limitações aceitas.

Se o portão falhar:

  • Refaça o inventário de HTML, metadados, arquivos de dados e conteúdo renderizado por JavaScript.
  • Substitua strings de marcador/origem perdidas.
  • Use edit-site-part para pequenos problemas de ajuste de layout causados pelo novo conteúdo.
  • Use review-static-site novamente após as correções.

1. Entradas

Use quaisquer materiais disponíveis:

  • Pasta do site estático, geralmente site/, dist/, out/ ou public/.
  • EDITING.md, mapa de páginas ou notas de transição de outra habilidade.
  • Biografia, currículo, CV, README do GitHub, página inicial antiga, lista de links de redes sociais, lista de projetos, avatar, logotipo ou detalhes de contato fornecidos pelo usuário.
  • Arquivos de dados existentes como profile.json, posts.json, projects.json ou blocos de dados em assets/script.js.
  • Instruções de substituição específicas do usuário.

Se informações importantes estiverem faltando, use placeholders claros em vez de inventar detalhes pessoais elaborados.

2. Inventário de Conteúdo

Antes de editar, identifique onde o conteúdo pessoal ou de marcador está localizado.

Verifique:

  • Arquivos HTML e subpáginas.
  • <title>, meta descrição, metadados Open Graph/Twitter, referências de favicon/logotipo e títulos visíveis.
  • Cabeçalho, navegação, hero, seções de perfil/sobre, blocos de contato, rodapé, barras laterais, cartões e sobreposições.
  • Conteúdo repetido em arquivos JSON, blocos de dados JavaScript ou listas HTML repetidas.
  • Páginas de demonstração de artigo/detalhe, páginas de projeto, páginas de notas, páginas de links e páginas especiais.
  • Instruções do EDITING.md e quaisquer locais de conteúdo documentados.

Procure por textos comuns de marcador ou demonstração, como seu nome, [email protected], exemplo.com, lorem ipsum, postagem de exemplo, projeto de exemplo, A FAZER, substitua-me e strings semelhantes.

3. Substituição de Identidade Pessoal

Substitua campos de identidade visíveis e em nível de código-fonte de forma consistente.

Campos típicos:

  • Título do site, nome do autor, nome de exibição, cargo, slogan, biografia curta, localização, disponibilidade/status e interesses.
  • E-mail, links de redes sociais, GitHub, X/Twitter, LinkedIn, Bluesky, RSS, newsletter, currículo/CV e outros links fornecidos pelo usuário.
  • Avatar, logotipo, favicon, texto alternativo, legendas de imagem e rótulos de perfil.
  • Texto do hero da página inicial, texto da página sobre, texto de contato, texto do rodapé e descrições de metadados.

Não invente empregadores específicos, escolas, prêmios, publicações, métricas, locais ou anos. Se o usuário não forneceu algo, mantenha neutro e fácil de substituir.

Ao substituir links ou ativos, preserve a compatibilidade com caminhos estáticos:

  • Mantenha links e ativos locais do site relativos à página, não absolutos à raiz.
  • De páginas raiz, use caminhos como assets/avatar.png, about.html e posts/example.html.
  • De páginas aninhadas, use a profundidade correta, como ../assets/avatar.png e ../index.html.
  • Não introduza /assets/..., /posts/..., /images/..., /data/... ou / para links internos, a menos que o site seja intencionalmente apenas para servidor raiz e o usuário aceite que a abertura direta de arquivos pode quebrar.
  • Links externos como GitHub, LinkedIn, e-mail e domínios pessoais podem permanecer URLs absolutos.

4. Limpeza de Site de Origem e Modelo

Ao personalizar uma recriação de estilo, remova a identidade do site original e o conteúdo específico da origem por padrão.

Substitua ou remova:

  • Nomes de autores originais, handles, domínios, e-mails, links de redes sociais, IDs de análise, links de amigos, URLs privadas, texto de licenciamento, estatísticas do site e links comunitários.
  • Catálogo de artigos original, texto do corpo do artigo, nomes de projetos, depoimentos pessoais e alegações pessoais.
  • Avatares, capas, capturas de tela, logotipos ou outros ativos baixados do site original, a menos que o usuário os possua ou tenha permissão.

Mantenha a estrutura visual e o padrão de interação, mas torne o conteúdo claramente pertencente ao usuário ou neutro como conteúdo de marcador.

5. Adaptação de Conteúdo

Adapte o material do usuário ao estilo e layout existentes do site, em vez de colar texto longo e bruto em todos os lugares.

Use o conceito do site para moldar o texto:

  • Site minimalista: conciso, calmo, direto.
  • Estilo terminal/arquivo: perfil, log, status, diretório ou texto semelhante a configuração.
  • Estilo Bento: trechos modulares curtos.
  • Página inicial de pesquisa: formal, precisa, orientada a projetos/publicações.
  • Blog ou jardim digital: tópicos de escrita, notas recentes, tags e caminhos de leitura.
  • Portfólio: trabalho selecionado, função, resultado, stack e links.

Mantenha os comprimentos de texto adequados aos contêineres existentes. Se um parágrafo fornecido pelo usuário for muito longo para um cartão, resuma-o e coloque a versão completa na página "Sobre".

Prefira editar fontes de dados centralizadas quando existirem. Se o conteúdo for repetido em vários arquivos, atualize todas as cópias visíveis e de metadados de forma consistente.

6. Validação

Use uma ferramenta de navegador interativa realmente disponível como a primeira opção para inspecionar a pré-visualização local e confirmar que o conteúdo personalizado está realmente visível nos lugares corretos. "Disponível" significa que está exposto na lista de ferramentas chamáveis do turno atual. No Codex, isso pode ser o plugin Browser/navegador no aplicativo quando roteado para o turno; em outros agentes, pode ser um navegador visível equivalente, ferramenta de uso de navegador ou navegador com ferramentas de desenvolvimento.

Se nenhuma ferramenta de navegador interativa for chamável, não finja que a verificação de posicionamento no navegador ocorreu. Peça ao usuário para habilitar ou invocar a ferramenta de navegador se o posicionamento visual for importante; para Codex, isso pode significar enviar uma solicitação que mencione explicitamente @browser. Se o usuário não redirecionar ou o cliente não tiver tal ferramenta, recorra a Playwright, capturas de tela, auditorias estáticas ou verificações de código-fonte e declare a limitação.

Não use Playwright ou validação apenas com capturas de tela como padrão quando uma ferramenta de navegador interativa for realmente chamável. Use Playwright apenas como fallback quando nenhuma ferramenta de navegador interativa for chamável, quando o usuário solicitar explicitamente ou quando for necessária uma regressão scriptada repetível.

Verifique as páginas que devem exibir as informações do usuário, como início, sobre/perfil, contato, projetos, links e páginas de artigo/detalhe representativas. Confirme que nome, slogan, biografia, avatar/logotipo, detalhes de contato, links de redes sociais, nomes de projetos e itens em destaque fornecidos pelo usuário aparecem onde esperado.

Confirme também que conteúdo importante de marcador ou identidade do site de origem não está mais visível no navegador. Esta é uma verificação de posicionamento de conteúdo, não uma validação completa de redesign visual.

Se a personalização alterou avatares, favicons, ícones de redes sociais, links de projetos, links de postagens ou cartões orientados a dados, confirme que os caminhos alterados funcionam a partir da profundidade da página afetada e que nenhum caminho absoluto acidental à raiz do site foi introduzido para links locais.

Chame ou sugira o uso de review-static-site ao final.

Guia de Edição

Atualize EDITING.md quando ele existir, ou crie-o se o site for destinado a ser reutilizável.

Registre:

  • Quais campos pessoais foram preenchidos.
  • Qual conteúdo permanece apenas como marcador.
  • Onde perfil, links, projetos, itens em destaque, postagens, imagens e texto do tema agora residem.
  • Quaisquer ativos fornecidos pelo usuário copiados para o site e onde são referenciados.
  • Qualquer conteúdo do site de origem intencionalmente removido ou substituído.

Mantenha o guia para agentes e usuários futuros, não como texto de marketing dentro do site.

Saída

Quando terminar, relate brevemente:

  • Quais informações pessoais e páginas foram atualizadas.
  • Quais arquivos foram alterados.
  • Quais placeholders ou resíduos específicos da origem permanecem, se houver.
  • Se review-static-site foi executado ou deve ser executado em seguida.

Não cole dados pessoais privados do usuário de volta desnecessariamente.

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 when the user wants to create, implement, redesign, or update a zero-dependency personal website, personal blog, homepage, portfolio, research homepage, or digital garden using plain HTML, CSS, and JavaScript. Use it after a theme direction has been chosen, or when the user wants a no-framework site that can be opened directly in the browser and deployed as static files.

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