Communitygithub.com

Gyschuaner/from-idea-to-personal-site

Use esta habilidade para fazer edições focadas e de pequeno escopo em um site estático gerado, blog pessoal, portfólio, jardim digital ou recriação de estilo. Utilize-a quando o usuário quiser ajustar uma seção de página, componente, detalhe visual, bloco de texto, problema responsivo ou interação leve sem reconstruir o site inteiro.

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

Esta habilidade, chamada 'Editar Parte do Site', é projetada para agentes de IA (como Claude Code, Cursor ou Codex) realizarem melhorias precisas e localizadas em sites estáticos já existentes. Diferente de uma geração completa do zero, ela foca em alterações cirúrgicas: modificar um bloco de herói, layout de cartão, barra lateral, rodapé, botão, menu mobile, espaçamento, cor, tipografia ou intensidade de animação. O agente recebe como entrada a pasta do site, a página alvo, uma URL local, uma captura de tela ou uma descrição em linguagem natural da região a ser alterada, além de arquivos como `EDITING.md` e os HTML/CSS/JS relevantes. O workflow inclui confirmar a região alvo no navegador antes e depois da edição, ler o guia de edição existente, fazer a menor alteração coerente possível e preservar o design atual, a menos que o usuário peça explicitamente uma mudança. A habilidade impõe limites claros: não reconstruir o site, não alterar temas, não importar posts, não personalizar muitos campos nem publicar. Para validação, usa um navegador interativo quando disponível, com fallback para Playwright ou inspeção de código, e verifica tanto desktop quanto dispositivos móveis. Se a edição falhar no teste visual, o agente corrige com o menor ajuste possível. Esta ferramenta é ideal para polimento iterativo, mantendo a integridade do resto do site intocado.

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

Perguntar na sua IA favorita

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

Documentação

Editar Parte do Site

Objetivo

Realizar uma melhoria direcionada em uma parte de um site estático existente, preservando o restante do site.

Esta habilidade é para polimento iterativo após o site já existir. Deve parecer uma edição local cuidadosa, não uma nova passada de geração.

Contrato

Entradas:

  • Pasta do site estático existente, página alvo, captura de tela/URL local, ou descrição em linguagem natural da região alvo.
  • EDITING.md e arquivos HTML/CSS/JS relevantes.
  • Alteração desejada de antes/depois para texto, estilo, comportamento responsivo ou pequena interação.

Saídas:

  • Uma edição focada na seção da página, componente, bloco de texto, regra de estilo ou interação leve afetada.
  • EDITING.md atualizado apenas quando as instruções de edição futura precisarem mudar.
  • Breve relatório de onde a mudança foi feita, arquivos alterados e validação realizada.

Limites:

  • Não reconstruir o site inteiro, mudar a direção do tema, importar posts, personalizar muitos campos ou publicar.
  • Não tocar em páginas/recursos não relacionados.
  • Não introduzir dependências, etapas de build ou caminhos absolutos locais do site (/...).

Critério de sucesso:

  • A mudança local solicitada é visível na mesma região do navegador que foi confirmada antes da edição.
  • Verificações de desktop/mobile ou interação passam para a superfície afetada.
  • Nenhuma alteração de layout ou navegação não relacionada foi introduzida.

Se o critério falhar:

  • Re-mapear a região do navegador para o código-fonte e fazer a menor edição corretiva.
  • Executar ou sugerir review-static-site quando o problema afetar navegação compartilhada, muitas páginas, recursos, codificação ou prontidão para publicação.

Quando Usar

Use esta habilidade quando o usuário pedir para:

  • Alterar uma seção, cartão, bloco, componente ou região de página.
  • Tornar um detalhe visual menor, mais calmo, mais denso, mais limpo, mais lúdico, mais técnico ou menos distrativo.
  • Corrigir um problema de layout mobile, estouro de texto, problema de espaçamento ou alinhamento estranho.
  • Ajustar uma pequena interação como hover, alternância de tema, comportamento de menu, botão de cópia, filtro, aba ou animação.
  • Reescrever ou encurtar um trecho específico de texto visível.
  • Corresponder a uma captura de tela ou comentário do usuário para uma área localizada.

Não use esta habilidade para geração completa de site, busca de temas, recriação próxima de um novo site de referência, substituição de grande conteúdo pessoal, migração de artigos, implantação ou conversão de framework.

Entradas

Use o que o usuário fornecer:

  • Pasta raiz do site e página alvo.
  • Uma captura de tela, visualização do navegador, URL local ou descrição em linguagem natural do problema.
  • O texto exato, nome da seção, nome da classe ou área visual a ser alterada.
  • EDITING.md, se presente.
  • Arquivos HTML/CSS/JS existentes.
  • Qualquer redação desejada de antes/depois ou direção de estilo.

Se a área alvo for ambígua, inspecione o site e faça a menor interpretação razoável. Peça um breve esclarecimento apenas quando múltiplas edições plausíveis produziriam resultados muito diferentes.

Fluxo de Trabalho

  1. Antes de editar, use o navegador para confirmar a página alvo e a região alvo.
  2. Leia o EDITING.md quando presente, depois inspecione os HTML/CSS/JS relevantes.
  3. Use busca para encontrar texto visível correspondente, IDs, classes, blocos de dados ou marcação semelhante a componentes.
  4. Mapeie a região do navegador confirmada para os arquivos-fonte relevantes, seletores, blocos de dados ou manipuladores de eventos.
  5. Faça a menor edição coerente que atenda à solicitação.
  6. Mantenha a linguagem de design existente, a menos que o usuário peça explicitamente para alterá-la.
  7. Após editar, retorne à mesma página e região no navegador e verifique a mudança lá.
  8. Relate o que mudou e mencione qualquer validação de acompanhamento necessária.

Controle de Escopo

Mantenha a edição local.

  • Prefira editar a seção, classe ou objeto de dados existente em vez de criar uma duplicata paralela.
  • Evite reescrever a página inteira quando uma alteração no nível da seção for suficiente.
  • Evite alterar variáveis CSS compartilhadas, a menos que o usuário queira uma mudança de estilo em todo o site.
  • Evite tocar em páginas, recursos ou conteúdo não relacionados.
  • Preserve a navegação, o mapa da página, a estratégia de placeholders e as convenções do EDITING.md.
  • Preserve a estratégia de caminhos do site; não introduza caminhos absolutos locais do site como /assets/..., /posts/..., /images/... ou /data/... durante uma edição local.
  • Se uma pequena solicitação expuser um problema estrutural maior, explique a compensação antes de fazer mudanças amplas.

Quando o usuário pedir uma mudança visual ampla em várias páginas, sugira usar uma habilidade de geração maior ou redesign em vez de esticar esta.

Localizar o Lugar Certo

Use uma busca em camadas:

  1. Busque pelo texto visível ou rótulos próximos.
  2. Busque no EDITING.md pelo mapa de seção/página.
  3. Inspecione links de navegação e nomes de arquivos de página.
  4. Inspecione tags semânticas como header, main, section, article, aside e footer.
  5. Inspecione seletores CSS e hooks de eventos JavaScript.
  6. Use ferramentas de desenvolvedor do navegador ou capturas de tela quando a localização no código-fonte não for óbvia.

Se conteúdo repetido for renderizado a partir de dados, edite os dados-fonte em vez de apenas a marcação que parece gerada.

Preservação de Design

Ajuste a edição ao site atual.

  • Reutilize espaçamento, tipografia, cores, bordas, sombras, ícones e padrões de movimento existentes.
  • Mantenha o texto dentro de seu contêiner tanto em desktop quanto mobile.
  • Evite que efeitos decorativos interfiram na leitura.
  • Respeite prefers-reduced-motion ao alterar animações.
  • Mantenha páginas de artigo/detalhe mais calmas do que páginas iniciais fortemente estilizadas, a menos que o usuário peça o contrário.
  • Não adicione um herói no estilo de marketing ou seção decorativa não relacionada a um site pessoal ou blog.

Ao alterar texto, combine com a voz existente e o idioma do usuário.

Edições de Interação

Para alterações em JavaScript ou interação:

  • Encontre ouvintes de evento e convenções de estado existentes antes de adicionar novos.
  • Mantenha JavaScript puro se o site for estático simples.
  • Evite introduzir dependências ou etapas de build.
  • Ao gerar links, resultados de busca, URLs de imagens ou itens de navegação em JavaScript, use caminhos relativos à página que funcionem a partir da profundidade da página afetada.
  • Teste estados de clique, teclado, mobile e uso repetido quando relevante.
  • Preserve acessibilidade básica como foco, rótulos e comportamento de movimento reduzido.

Correções Responsivas

Para problemas de layout ou mobile:

  • Verifique larguras de desktop e mobile.
  • Prefira alterações CSS que preservem o layout de desktop enquanto corrigem telas estreitas.
  • Use dimensões estáveis, quebra de linha, larguras mín/máx, ajustes de grid/flex e controle de estouro.
  • Não oculte conteúdo importante no mobile apenas para fazer o layout caber.

Guia de Edição

Se a mudança afetar como futuras edições devem ser feitas, atualize o EDITING.md.

Atualize-o quando:

  • Uma nova seção, classe, campo de dados ou padrão de interação for introduzido.
  • O armazenamento de conteúdo mudar para um novo arquivo ou objeto de dados.
  • O usuário solicitou uma mudança que agentes futuros podem precisar preservar.

Não atualize o EDITING.md para pequenas alterações de texto ou espaçamento, a menos que o guia se torne enganoso.

Validação

Valide a superfície afetada, não necessariamente o site inteiro.

Use uma ferramenta de navegador interativa realmente disponível antes de editar para confirmar a página alvo e a região. "Disponível" significa que está exposta na lista de ferramentas invocáveis da rodada atual. No Codex, pode ser a ferramenta Navegador/navegador no aplicativo quando roteada para a rodada; em outros agentes, pode ser um navegador visível equivalente, ferramenta de uso do navegador ou navegador com ferramentas de desenvolvedor. Após editar, retorne à mesma página e região no navegador interativo para verificar o resultado.

Se nenhuma ferramenta de navegador interativa for invocável, não finja que a confirmação de antes/depois no navegador aconteceu. Peça ao usuário para habilitar ou invocar a ferramenta de navegador se a edição depender de mapeamento de região visual; 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 ao Playwright, capturas de tela ou inspeção de código-fonte e mencione a limitação.

Não recorra ao Playwright, validação apenas por capturas de tela ou apenas inspeção de código-fonte quando uma ferramenta de navegador interativa for realmente invocável. Use Playwright apenas como fallback quando nenhuma ferramenta de navegador interativa for invocável, quando o usuário pedir explicitamente ou quando uma regressão de script repetível for especificamente necessária.

Para edições visuais, responsivas ou interativas, verifique a região alterada nas viewports relevantes de desktop/mobile e teste a interação alterada.

Execute ou sugira review-static-site apenas quando a edição afetar navegação compartilhada, layout global, muitas páginas, caminhos de recursos, codificação de fonte ou prontidão para publicação.

Se a edição tocar em href, src, CSS url(...), imagens, fontes, favicons, arquivos de dados ou URLs gerados por JavaScript, verifique se a página afetada ainda funciona com caminhos relativos à página e se abrir o arquivo estático diretamente não perderá CSS, JS ou imagens.

Saída

Para edições locais, relate apenas:

  • Onde a mudança foi feita.
  • Quais arquivos foram alterados.
  • Qual validação foi realizada.

Mencione validação mais ampla com review-static-site apenas quando for realmente recomendada. Não repita o relatório nem explique demais todo o código-fonte.

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 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

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