Communitygithub.com

Gyschuaner/da-ideia-ao-site-pessoal

Use esta habilidade para adicionar, importar ou migrar uma ou mais postagens de blog, notas, ensaios, artigos, arquivos Markdown, documentos do Word ou pastas de conteúdo de escrita rica em um site ou blog pessoal estático existente, preservando o estilo atual do artigo, estrutura de conteúdo, navegação, índices, arquivos, tags, ativos, matemática, links, tabelas, blocos de código, incorporações e pontos de entrada da página inicial. Use-a para postagens coladas, arquivos Markdown locais, notas do Obsidian, rascunhos .docx, postagens HTML estáticas antigas, conteúdo de blog exportado ou lotes de pequeno a médio porte de postagens após o site já ter sido criado.

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

Esta skill (`Gyschuaner/from-idea-to-personal-site`) foi projetada especificamente para ajudar desenvolvedores e criadores de conteúdo a adicionar conteúdo novo a um site estático pessoal existente sem interromper o design ou a arquitetura de conteúdo atual. Diferentemente de conversores genéricos de Markdown para HTML, esta skill primeiro analisa a estrutura de postagem atual do site, incluindo seus modelos, indexação, tags, manipulação de ativos e entrada de página inicial, para garantir que o novo conteúdo corresponda perfeitamente a esses padrões. Ela suporta uma ampla variedade de formatos de origem, como Markdown, notas do Obsidian, documentos Word (.docx), HTML antigo, texto colado e pastas de conteúdo, extraindo ou inferindo metadados como título, data e tags sem inventar informações não suportadas. A skill lida com conteúdo rico de forma inteligente, preservando renderização matemática (KaTeX/MathJax), destaque de código, tabelas, notas de rodapé, callouts, links internos (incluindo wikilinks do Obsidian) e incorporações de mídia, ao mesmo tempo em que copia e religa imagens locais e anexos com caminhos relativos à página. É adequada para plataformas como Claude Code, Cursor e Codex, que são ferramentas de desenvolvimento de agentes de IA comumente usadas para gerenciar sites estáticos. A skill opera dentro de limites claros: ela não reprojeta o site, não introduz dependências remotas silenciosamente, não publica o site (usando `publish-static-site` para isso) e não cria novos sistemas de postagem se um já existir. O sucesso é medido pela renderização correta de novas postagens no estilo existente, acessíveis a partir de índices apropriados, com todos os ativos funcionando e as páginas passando pela validação do navegador.

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

Perguntar na sua IA favorita

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

Documentação

Adicionar Postagens de Blog

Objetivo

Adicionar conteúdo do usuário a um blog estático existente sem forçar um novo sistema de blog.

Esta habilidade deve primeiro entender como o site atual já representa postagens, depois adicionar novo conteúdo nesse estilo. Não é um conversor genérico de Markdown para HTML.

Contrato

Entradas:

  • Pasta do site estático existente e seu sistema atual de postagens/índices/modelos.
  • Uma ou mais postagens de origem: Markdown, notas do Obsidian, documentos do Word, HTML antigo, texto colado, imagens, anexos ou pastas de conteúdo.
  • Metadados opcionais como título, data, tags, resumo, slug, imagem de capa e escopo de importação.

Saídas:

  • Novas páginas de artigo/detalhe que correspondem ao estilo de artigo existente do site.
  • Pontos de entrada atualizados, como índice do blog, arquivo, tags/categorias, postagens recentes da página inicial, dados de pesquisa, RSS ou sitemap, quando esses sistemas já existem.
  • Imagens e anexos locais copiados/religados com caminhos relativos à página.
  • Instruções de postagem EDITING.md atualizadas, quando aplicável.

Limites:

  • Não redesenhe o site ou crie um novo sistema de postagem quando um existente for claro.
  • Não invente metadados, datas, autores ou alegações que a fonte não suporte.
  • Não adicione dependências remotas de matemática/CDN silenciosamente.
  • Não publique; use publish-static-site.

Portão de sucesso:

  • Novas postagens são renderizadas no estilo existente e são acessíveis a partir dos índices apropriados.
  • Imagens, matemática, links, código, tabelas e conteúdo rico funcionam ou itens não resolvidos são relatados explicitamente.
  • Caminhos são relativos à página a partir de páginas de artigo e índice.
  • Páginas afetadas passam pela validação do navegador e review-static-site pode passar ou apenas relatar limitações aceitas.

Se o portão falhar:

  • Corrija conversão, metadados, caminhos, ativos ou conexão de índice nesta habilidade.
  • Use edit-site-part para pequenos ajustes visuais causados pela importação.
  • Use review-static-site novamente após as correções.

Quando Usar

Use esta habilidade quando o usuário quiser:

  • Adicionar um novo artigo, nota, ensaio ou postagem de blog.
  • Importar vários arquivos Markdown em um site estático.
  • Mover postagens de um blog antigo para um novo site gerado.
  • Converter texto de artigo colado em uma página de artigo do site.
  • Atualizar o índice do blog, arquivo, tags, postagens recentes da página inicial ou pontos de entrada relacionados.
  • Preservar a linguagem visual atual do site enquanto adiciona conteúdo.

Não use esta habilidade para escolher um tema, construir um novo site do zero, recriar o estilo de um site, personalizar conteúdo de perfil/sobre, fazer um pequeno ajuste visual, publicar o site ou converter o projeto para um framework.

Entradas

Use o que estiver disponível:

  • Pasta do site estático, geralmente site/, dist/, out/ ou public/.
  • Um ou mais arquivos Markdown, documentos do Word, postagens coladas, arquivos HTML antigos, pastas de imagens ou pastas de conteúdo.
  • EDITING.md, mapa de página ou notas de transferência de habilidades anteriores.
  • Páginas de modelo de artigo existentes ou postagens representativas.
  • Título, data, tags, categoria, resumo, slug, imagem de capa e preferência de publicação fornecidos pelo usuário.
  • Se importar todas as postagens, um subconjunto selecionado ou um lote representativo primeiro.

Se o conteúdo de origem for grande, inspecione a estrutura primeiro e evite importar tudo cegamente.

1. Entenda o Sistema de Postagem Existente

Antes de escrever novas postagens, inspecione como o site funciona atualmente.

Verifique:

  • Arquivos de postagem como posts/*.html, notes/*.html, articles/*.html ou pastas de rota aninhadas.
  • Páginas de índice como blog.html, archive/index.html, notes/index.html, tags/index.html ou category/index.html.
  • Arquivos de dados como data/posts.json, data/notes.json, data/site.json ou profile.json.
  • Matrizes de dados JavaScript em assets/script.js ou arquivos semelhantes.
  • Seções da página inicial para postagens recentes, postagens em destaque, notas, listas de leitura ou destaques de escrita.
  • Páginas de artigo/detalhe existentes que podem ser usadas como modelos.
  • Estratégia de caminho existente: se os modelos usam links relativos à página, como ../assets/style.css, ou links raiz do servidor, como /assets/style.css.
  • RSS, Atom, sitemap, índice de pesquisa ou páginas de tag/categoria, se já presentes.
  • Instruções EDITING.md para adicionar postagens.
  • Convenções existentes de imagem e anexo, como assets/images/posts/, pastas de postagem colocalizadas, campos de capa, classes de figura, marcação lightbox, legendas ou wrappers de imagem responsivos.
  • Convenções existentes de conteúdo rico, como renderização matemática, destaque de código, tabelas, notas de rodapé, callouts, âncoras de cabeçalho, índice, cartões de link, incorporações, diagramas e seções de citação/referência.

Siga a estrutura existente. Não invente um novo sistema de postagem quando o site já tiver um.

2. Extrair Metadados da Postagem

Para cada postagem de origem, extraia ou derive:

  • Título.
  • Data.
  • Slug.
  • Tags ou categoria.
  • Resumo ou trecho.
  • Imagem de capa ou imagem herói, se presente e utilizável.
  • Caminho de origem.
  • Tempo de leitura, apenas se o site atual já o usa ou é fácil de calcular de forma consistente.

Use frontmatter quando presente. Caso contrário, infira a partir do primeiro título, nome do arquivo, pasta circundante, texto de data visível ou primeiro parágrafo.

Não invente datas, tags, autores ou alegações específicas. Se um campo estiver faltando e não puder ser inferido, use um espaço reservado claro ou omita o campo quando o estilo do site permitir.

3. Converter Conteúdo para o Estilo do Site

Crie novas páginas de artigo correspondendo ao modelo de artigo existente e à experiência de leitura.

Preserve:

  • Cabeçalho, navegação, rodapé, barras laterais e shell compartilhado.
  • Tipografia do artigo, espaçamento, layout de metadados, tags, links de volta e links relacionados.
  • Qualquer linguagem de tema especial, como entradas de registro, notas de campo, cartões, moldura de terminal/arquivo ou ensaios mínimos.
  • Convenções de classe CSS existentes e estruturas de dados.

Para Markdown:

  • Converta cabeçalhos, parágrafos, blockquotes, listas, listas de tarefas, tabelas, blocos de código, links, notas de rodapé, callouts e imagens em HTML semântico.
  • Preserve rótulos de idioma de código quando disponíveis.
  • Mantenha referências de imagem relativas à página e copie imagens locais apenas quando necessário.
  • Mantenha chinês, japonês, coreano, latim acentuado e outro texto não-ASCII como UTF-8 legível.

Para HTML antigo:

  • Extraia o corpo do artigo e os metadados.
  • Remova chrome antigo do site, análises, comentários, navegação não relacionada e identidade do site de origem.
  • Reenvolva o conteúdo no modelo de artigo do novo site.

3.5. Preservar Compatibilidade de Caminho Estática

Ao adicionar postagens, calcule caminhos a partir da localização de cada página gerada. Não copie caminhos de index.html cegamente em páginas de artigo aninhadas.

Regras padrão:

  • Novas páginas de artigo devem usar links relativos à página para CSS, JavaScript, fontes, imagens e navegação compartilhados.
  • Se a postagem for gerada em posts/my-post.html, ativos compartilhados geralmente precisam de ../assets/style.css, ../assets/script.js e imagens de postagem como ../assets/images/posts/my-post/figure.png.
  • Links de páginas raiz para a postagem geralmente devem ser posts/my-post.html.
  • Links da postagem de volta para páginas raiz geralmente devem ser ../index.html, ../blog.html ou ../archive/index.html, dependendo da estrutura.
  • Não introduza caminhos absolutos de raiz como /assets/..., /posts/..., /data/... ou /images/... a menos que o site existente os use intencionalmente e o usuário aceite que a abertura direta de file:// e hospedagem de subcaminho podem quebrar.
  • Atualize links gerados por JavaScript, resultados de pesquisa, filtros de tag, links de postagens relacionadas, caminhos de capa, entradas RSS/sitemap e quaisquer arquivos de dados com a mesma estratégia de caminho.
  • Se o site existente já tiver links absolutos de raiz por acidente, relate e prefira corrigir os caminhos afetados em vez de estender o problema.

Evite problemas de busca de arquivo local:

  • Não faça postagens recém-adicionadas dependerem de fetch() de JSON/Markdown local para o corpo do artigo.
  • Se os índices forem renderizados a partir de dados, mantenha links essenciais de postagem visíveis em HTML ou use um objeto de dados JavaScript relativo que funcione com visualização de abertura direta.

4. Lidar com Formatos de Conteúdo Rico

Preserve conteúdo rico intencionalmente em vez de achatar tudo em parágrafos simples.

Primeiro inspecione se o site atual já suporta:

  • Renderização matemática com KaTeX, MathJax, CSS personalizado ou blocos TeX brutos.
  • Destaque de código, rótulos de idioma, botões de cópia ou molduras de código estilo terminal.
  • Tabelas, wrappers de tabela responsivos, notas de rodapé, callouts, admoestações, citações e listas de tarefas.
  • Âncoras de cabeçalho, índice, backlinks, notas relacionadas ou links de seção.
  • Cartões de link, listas de favoritos, páginas de índice de URL, citações, listas de referência ou seções de bibliografia.
  • Mídia incorporada como vídeo, áudio, PDFs, iframes, diagramas Mermaid, diagramas Excalidraw/SVG ou anexos para download.

Siga o padrão existente quando um existir. Se nenhum padrão existir, use HTML semântico simples e relate qualquer recurso que precise de um renderizador adicional.

Matemática e fórmulas:

  • Preserve matemática inline e display de $...$, $$...$$, \(...\), \[...\] ou exportações de equações do Word.
  • Use o renderizador matemático existente do site, se presente.
  • Se a fonte contém muitas fórmulas e nenhum renderizador existe, prefira uma integração local de KaTeX para sites estáticos simples: armazene CSS/JS/fontes do KaTeX em uma pasta vendor local, adicione um pequeno script de renderização local e não dependa de um CDN.
  • Não adicione silenciosamente uma dependência remota de MathJax/KaTeX a um site que de outra forma não tem dependências.
  • Preserve o TeX original dentro de elementos marcados com matemática como fallback, depois renderize no navegador. Se a renderização falhar para uma fórmula, o fallback TeX legível deve permanecer visível em vez de quebrar a página.
  • Normalize sintaxe de origem óbvia que o KaTeX precisa, como setas softmax, \cdot, \times, pontuação acidentalmente misturada em fórmulas e expressões comuns de Q/K/V.
  • Não deixe postagens pesadas de fórmulas como caixas TeX que parecem código quando um renderizador matemático foi adicionado.
  • Mantenha fórmulas legíveis na fonte e no fallback do navegador.

Blocos de código:

  • Preserve nomes de idioma de código cercado.
  • Escape HTML dentro de blocos de código.
  • Mantenha longas linhas de código roláveis em vez de quebrar o layout da página.
  • Reutilize estilo de bloco de código existente, botões de cópia e convenções de destaque de sintaxe.
  • Não execute código fonte de postagens.

Tabelas:

  • Converta tabelas Markdown, Word ou HTML em tabelas semânticas.
  • Envolva tabelas largas no contêiner responsivo de tabela existente do site ou adicione um pequeno wrapper local.
  • Preserve linhas de cabeçalho, intenção de alinhamento e legendas quando disponíveis.

Links, índices de URL e referências internas:

  • Preserve links externos com texto de link claro.
  • Converta links relativos e links .md do Markdown para o caminho HTML estático gerado quando a postagem de destino for importada.
  • Converta wikilinks do Obsidian como [[Note]], [[Note#Heading]] e [[Note|Alias]] em links normais quando o destino puder ser resolvido.
  • Preserve links internos não resolvidos como espaços reservados visíveis ou texto simples, e relate-os.
  • Gere IDs de cabeçalho estáveis quando o site usa links de âncora ou índice.
  • Para índice de URL, favoritos ou postagens de resumo de links, mantenha a estrutura de lista. Use o estilo de cartão de link/lista existente do site quando presente; não invente cartões de visualização que exijam busca de metadados remotos, a menos que o usuário peça.

Notas de rodapé, citações e referências:

  • Converta notas de rodapé Markdown em uma seção de notas de rodapé usando o estilo existente do site, se presente.
  • Preserve rótulos de citação, entradas de bibliografia e links de referência.
  • Se o texto de origem usar chaves de citação não resolvidas como [@paper2024], mantenha-os visíveis e relate que os metadados de citação estão faltando, a menos que um arquivo de bibliografia seja fornecido.

Callouts, admoestações e tipos de bloco:

  • Converta callouts estilo Obsidian/GitHub como > [!NOTE], > [!TIP], > [!WARNING] e > [!IMPORTANT] no padrão de callout/cartão/blockquote mais próximo do site.
  • Preserve listas de tarefas como listas de verificação quando o site atual tiver estilo de lista de verificação; caso contrário, use marcação de caixa de seleção desabilitada ou listas simples.

Incorporações e anexos:

  • Para PDFs, slides, conjuntos de dados, downloads, áudio e vídeo, prefira um link claro ou cartão de download, a menos que o site já incorpore esse tipo de mídia.
  • Copie anexos locais apenas quando fornecidos pelo usuário.
  • Mantenha incorporações remotas apenas quando o usuário as possui ou as referencia intencionalmente.
  • Para blocos Mermaid ou diagrama, use o renderizador existente se presente. Se nenhum renderizador existir, preserve o bloco de origem e relate-o, ou converta para um SVG/PNG estático apenas quando prático e apropriado.

5. Lidar com Imagens e Ativos da Postagem

Lide com imagens de acordo com as convenções de ativos atuais do site.

Primeiro inspecione como as postagens existentes armazenam e renderizam imagens:

  • Pasta de ativos compartilhada como assets/images/posts/<slug>/.
  • Ativos de postagem colocalizados como posts/<slug>/images/.
  • Campos de dados como cover, heroImage, thumbnail ou images.
  • Marcação de figura, legendas, links lightbox, carregamento preguiçoso, atributos de largura/altura e classes CSS responsivas.

Prefira o padrão existente. Se nenhum padrão existir, use uma convenção estática simples como:

assets/images/posts/<post-slug>/

Para fontes Markdown:

  • Resolva links de imagem relativos a partir da pasta do arquivo Markdown.
  • Copie imagens locais para a pasta de imagens de postagem do site quando necessário.
  • Reescreva referências de imagem Markdown para os novos caminhos relativos do site.
  • Para páginas de artigo aninhadas, inclua a profundidade ../ correta nos caminhos de imagem.
  • Preserve texto alternativo do Markdown quando presente.
  • Converta legendas de imagem se a fonte usar texto itálico próximo, atributos title ou incorporações estilo Obsidian.
  • Não deixe links apontando para caminhos absolutos de disco local.

Para notas do Obsidian:

  • Suporte incorporações comuns como ![[image.png]] e pastas de anexo relativas.
  • Pesquise pastas de anexo prováveis perto da nota, como attachments/, assets/, images/ ou a pasta de anexo configurada do cofre quando visível.
  • Reescreva incorporações em marcação HTML de imagem ou figura normal.

Para fontes Word .docx:

  • Extraia imagens incorporadas do pacote de documento ou use ferramentas de documento disponíveis.
  • Preserve a ordem da imagem em relação ao texto circundante quando possível.
  • Salve imagens extraídas sob a pasta de imagens de postagem com nomes estáveis.
  • Use legendas próximas ou texto alternativo quando disponíveis.

...

[truncado para tradução]

Individual skills in this repo

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

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

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