Communitygithub.com

Gyschuaner/from-idea-to-personal-site

Use esta habilidade depois que a direção de estilo de um site pessoal ou blog estiver aproximadamente definida e antes de construir um site original. Ela busca sites reais, templates, portfólios, blogs, capturas de tela ou exemplos de design que correspondam à direção escolhida, inspeciona-os com ferramentas de navegador ou captura de tela quando disponíveis e transforma os achados em um resumo prático de referência de design para o make-personal-site. Use-a para solicitações como encontrar referências para um blog técnico natural, uma homepage de pesquisa aconchegante, um portfólio brutalista, um jardim digital, um site de notas minimalista ou qualquer direção visual nomeada que ainda precise de exemplos concretos.

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

Este skill transforma uma direção de estilo de site pessoal vagamente definida em referências de design concretas e verificadas antes da implementação. Ele não constrói o site nem clona um alvo único, mas sim pesquisa múltiplas fontes (sites reais, templates, portfólios, blogs), inspeciona os candidatos mais fortes usando ferramentas de navegador interativas quando disponíveis (como o plugin Browser do Codex ou ferramentas similares em outros agentes), extrai padrões de design reutilizáveis e sintetiza um resumo de construção pronto para o skill `make-personal-site`. O skill cobre layout, navegação, tipografia, cor, interações e comportamento responsivo, fornecendo notas claras sobre o que 'pegar emprestado' e o que 'evitar'. Ele é útil para desenvolvedores e agentes de IA que precisam de diretrizes visuais sólidas antes de codificar um site original, evitando designs genéricos ou cópia direta de conteúdo protegido. Suporta plataformas como v0, comunidade Figma, temas GitHub, Astro, Hugo, Jekyll, Quartz e sites de inspiração de design, e lida com cenários onde a direção de estilo não está clara, redirecionando para `search-blog-theme` ou `copy-website-style` conforme necessário.

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

Perguntar na sua IA favorita

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

Documentação

Encontrar Referências de Estilo

Objetivo

Transformar uma direção de estilo de site pessoal escolhida ou vagamente descrita em referências de design concretas e verificadas antes da implementação.

Esta habilidade é uma habilidade de pesquisa e resumo de design. Ela não constrói o site e não clona um único site alvo. Ela encontra múltiplas referências reais, as inspeciona, extrai padrões de design reutilizáveis e produz um resumo pronto para construção para make-personal-site.

Contrato

Entradas:

  • Direção de estilo do usuário, palavras de tema, tipo de site, público, escopo de conteúdo, referências ou restrições.
  • Exemplos opcionais para incluir ou evitar, fontes de plataforma/template preferidas e estrutura alvo do site.

Saídas:

  • 4-8 candidatos de referência relevantes quando disponíveis, com URLs de origem e uma breve justificativa.
  • Observações de navegador ou captura de tela para referências selecionadas quando a ferramenta estiver disponível.
  • Um resumo prático de referência cobrindo layout, navegação, primeira tela, lista de artigos, detalhe de artigo, áreas de projeto/sobre, cor, tipografia, imagens, movimento, interações e comportamento responsivo.
  • Notas claras de "pegar emprestado" e "evitar".
  • Um repasse final de construção para make-personal-site.

Limites:

  • Não implementar o site.
  • Não copiar código-fonte protegido, imagens, identidade pessoal, IDs de analytics ou ativos de marca.
  • Não tratar uma referência como alvo de clonagem. Se o usuário quiser um site específico copiado, encaminhar para copy-website-style.
  • Não gastar tempo com instalação de frameworks ou viabilidade de construção; esta habilidade apenas estuda referências de design.

Portão de sucesso:

  • A direção está fundamentada em referências concretas e é específica o suficiente para make-personal-site construir um site estático original.
  • A pesquisa de referências usou múltiplos ângulos de busca, não uma única palavra-chave.
  • Pelo menos 3 referências fortes foram inspecionadas quando possível, a menos que o usuário tenha pedido explicitamente um rascunho rápido.
  • O resumo final separa a linguagem de design reutilizável do conteúdo/identidade que não deve ser copiado.

Se o portão falhar:

  • Pesquisar com palavras-chave mais amplas ou alternativas.
  • Inspecionar um conjunto menor de referências mais fortes.
  • Retornar para search-blog-theme se a direção ainda não estiver clara.
  • Fazer apenas uma pergunta concisa de preferência quando múltiplas famílias de referência levariam a sites muito diferentes.

Quando Usar

Use esta habilidade quando:

  • O usuário já deu uma direção ampla, como blog técnico natural, homepage de pesquisa tranquila, arquivo de terminal retrô, site de notas aconchegante ou portfólio brutalista.
  • search-blog-theme recomendou uma direção, mas ainda precisa de exemplos reais antes de construir.
  • from-idea-to-personal-site está prestes a construir um site original a partir de palavras de gosto em vez de uma URL de referência concreta.
  • O agente precisa de mais fundamentação visual antes de make-personal-site.

Não use esta habilidade quando:

  • O usuário ainda não escolheu nenhuma direção; use search-blog-theme.
  • O usuário forneceu uma URL alvo e quer recriação próxima; use copy-website-style.
  • O site já existe e só precisa de uma pequena alteração; use edit-site-part.

Fluxo de Trabalho

  1. Reafirmar a direção de estilo internamente como palavras-chave pesquisáveis. Entrada: gosto do usuário e propósito do site. Saída: 5-10 frases de pesquisa em múltiplos ângulos. Portão: as frases de pesquisa cobrem humor, tipo de site, sistema visual, estrutura e pelo menos uma paráfrase alternativa.

  2. Pesquisar referências reais. Entrada: frases de pesquisa. Saída: sites candidatos, templates, portfólios, blogs, páginas de design ou demos no GitHub. Portão: usar pelo menos 3 ângulos de busca distintos antes de decidir as referências, a menos que o usuário tenha pedido explicitamente um rascunho rápido.

  3. Inspecionar referências selecionadas. Entrada: principais candidatos. Saída: observações de navegador/captura de tela. Portão: pelo menos 3 referências fortes são inspecionadas quando possível; usar 4-6 quando a direção for ampla.

  4. Extrair padrões de design. Entrada: referências inspecionadas. Saída: padrões reutilizáveis e antipadrões. Portão: as notas são sobre layout, hierarquia, interação, tipografia, cor, densidade de conteúdo e comportamento responsivo, não apenas vibes.

  5. Sintetizar um resumo de construção. Entrada: padrões de referência mais restrições do usuário. Saída: um resumo conciso de design para make-personal-site. Portão: o resumo é específico o suficiente para ser implementado sem outra passada de pesquisa.

Orientação de Pesquisa

Construir pesquisas a partir de combinações de:

  • Tipo de site: site pessoal, blog pessoal, portfólio, homepage de pesquisa, jardim digital, site de notas, blog de desenvolvedor.
  • Humor: natural, calmo, editorial, aconchegante, cru, brutalista, terminal, arquivo, caderno, jardim, minimalista, lúdico, científico.
  • Estrutura: homepage de blog, índice de artigos, grade de projetos, navegação lateral, bento, linha do tempo, arquivo de notas, página "agora".
  • Fontes: templates v0, comunidade Figma, temas GitHub, sites pessoais, exemplos de Astro/Hugo/Jekyll/Quartz, sites de inspiração de design.

Preferir frases específicas em vez de vagas. Por exemplo:

  • site pessoal de desenvolvedor natural
  • blog técnico calmo site pessoal
  • jardim digital design inspirado na natureza
  • homepage de pesquisa site pessoal minimalista
  • template de blog pessoal notas projetos

Não parar após uma frase de pesquisa ou o primeiro resultado atraente. Para uma direção como homepage técnica cyberpunk, pesquisar em múltiplos ângulos, como:

  • site pessoal de desenvolvedor cyberpunk
  • blog técnico futurista site pessoal
  • portfólio cyberpunk terminal
  • site pessoal brutalista neon
  • homepage pessoal interface sci-fi

Usar busca na web atual para referências porque templates, portfólios e exemplos de design mudam com o tempo.

Inspeção no Navegador

Para cada referência forte, inspecionar a página ao vivo com uma ferramenta de navegador interativa realmente disponível. "Disponível" significa que está exposta 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 browser-use ou navegador com suporte a devtools.

Se nenhuma ferramenta de navegador interativa for chamável, não fingir que a referência foi inspecionada visualmente em um navegador. Pedir ao usuário para ativar ou invocar a ferramenta de navegador se a fidelidade da referência 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, recorrer a Playwright, capturas de tela, trechos de resultados de busca, páginas fonte ou descrições escritas e declarar a limitação.

Não usar Playwright, revisão apenas com capturas de tela ou trechos de resultados de busca como padrão quando uma ferramenta de navegador interativa for realmente chamável. Capturas de tela podem ser capturadas como evidência após a passada interativa no navegador, mas não substituem a inspeção interativa. Usar Playwright apenas como fallback quando nenhuma ferramenta de navegador interativa for chamável, quando o usuário pedir explicitamente ou quando uma comparação repetível e scriptada for especificamente necessária.

Verificar:

  • Primeiro viewport: o que é imediatamente útil?
  • Navegação: navegação superior, navegação lateral, comando/menu, tags, pesquisa, links de arquivo.
  • Modelo de conteúdo: posts, notas, projetos, sobre, links, registros, agora, jardim, currículo.
  • Experiência de leitura: largura do artigo, tipografia, blocos de código, matemática, imagens, notas de rodapé, índice.
  • Sistema visual: paleta, espaçamento, raio de borda, densidade, cards, divisores, textura, imagens.
  • Movimento e interação: estados de hover, alternância de tema, filtros, pesquisa, efeitos de rolagem, transições de página.
  • Comportamento responsivo: o que deve acontecer no celular?
  • Risco: o que se tornaria muito difícil de ler, muito genérico, muito pesado ou muito próximo da fonte?

Se a ferramenta de navegador não estiver disponível, usar páginas fonte, trechos de resultados de busca, capturas de tela e notas escritas, e declarar que a inspeção visual foi limitada.

Forma da Saída

Manter a resposta natural e útil. Não expor um longo log de processo oculto.

Incluir:

  • Recomendação curta: a direção mais forte para construir.
  • Referências: 4-8 itens com URL/fonte e por que cada um importa.
  • Pegar emprestado: padrões concretos para adaptar.
  • Evitar: coisas para não copiar ou que prejudicariam o site do usuário.
  • Resumo de construção: a direção exata para make-personal-site.
  • Repasse: próxima habilidade recomendada e quaisquer restrições de fonte.

Quando o usuário pedir uma resposta rápida, comprimir a saída para as melhores 3-5 referências e um resumo.

Requisitos do Resumo de Construção

O resumo final deve especificar:

  • Identidade do site: como o site deve parecer em uma frase.
  • Escopo de páginas: home, índice de blog, detalhe de post, projetos, sobre, notas/registros, links ou outras páginas.
  • Primeira tela: qual conteúdo útil aparece imediatamente.
  • Layout: navegação, colunas de conteúdo, barras laterais, cards/listas, estrutura de arquivo.
  • Sistema visual: paleta de cores, estilo de tipo, espaçamento, bordas, imagens, estilo de ícone.
  • Interações: alternância de tema, filtro/pesquisa, botões de cópia, estados de hover, movimento opcional.
  • Comportamento responsivo: navegação móvel e prioridade de conteúdo.
  • Não copiar: identidade pessoal original, artigos, ativos, logotipos, código proprietário, analytics ou tratamento exato de marca.

Repasse

Após o resumo estar pronto:

  • Rotear construções de site original para make-personal-site.
  • Rotear recriações próximas de um único site para copy-website-style.
  • Rotear escolhas de direção não resolvidas de volta para search-blog-theme.

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

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

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