Communitygithub.com

GiantClam/shpitto

Contrato de geração específico para sites de portfólio pessoal e blog. Use para currículos, sites de criadores, perfis de consultores e sites pessoais focados em escrita.

O que é shpitto?

Este skill define um contrato de geração rigoroso e específico para a criação de sites de portfólio pessoal e blog, como aqueles usados por criadores, consultores e profissionais que desejam exibir seu trabalho e escrita. Ele é projetado para plataformas como Claude Code, Cursor e Codex, garantindo que o agente de IA produza layouts que priorizam a identidade pessoal, a narrativa editorial e a credibilidade, em vez de genéricos temas corporativos. O contrato detalha a estrutura da página inicial, que deve ser liderada pelo perfil e incluir seções como masthead, pilares de expertise e amostras de escrita, além de especificar a hierarquia visual e a identidade do blog, que deve ter um tom editorial mais quente e tipografia legível. O skill também impõe regras para a geração de páginas de blog (`/blog`), exigindo que a primeira versão entregue uma página de arquivo robusta, deixando a criação de páginas de detalhes para uma etapa separada, e proíbe o uso de placeholders visuais de baixa informação, como gradientes ou retângulos vazios, favorecendo imagens reais ou módulos de prova substanciais. Em resumo, ele evita que o agente caia em padrões corporativos genéricos e força a criação de um site pessoal refinado, com shell compartilhado consistente (header, footer e navegação) e exclusão de cópias de implementação ou placeholders.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GiantClam/shpitto/tree/HEAD/apps/web/skills/portfolio-blog-site

Perguntar na sua IA favorita

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

Documentação

Site de Portfólio e Blog

Use este skill quando o site representar um indivíduo, criador, consultor ou perfil pessoal focado em escrita.

Contrato central

  • A identidade pessoal e o ponto de vista podem liderar a página inicial.
  • Blog ou escrita podem ser uma rota de primeira classe e superfície narrativa.
  • Narrativa, ritmo editorial e storytelling de perfil são permitidos aqui de maneiras que não são para corporate-b2b-site.
  • Não force expectativas de shell de empresa em um site verdadeiro de portfólio/blog.

Contrato da página inicial

  • A página inicial deve apresentar a pessoa nomeada, seu julgamento técnico e por que o público deve confiar em sua escrita ou serviços antes de direcionar os visitantes para /blog.
  • Trate / como uma página inicial editorial liderada pelo perfil, não como um herói de marketing genérico e não como um diretório de artigos compactado.
  • Sequência preferida da página inicial:
    • masthead liderado pelo perfil
    • pilares de expertise ou editoriais
    • faixa selecionada de escrita/prova
    • CTA conciso ou faixa de contato
  • Não deixe a página inicial parecer um explicador de arquivo, nota de ordem de rota ou painel de mecânica "comece aqui".
  • Se a abertura da página inicial ou a primeira faixa de suporte usar um slot visual, esse slot deve ser:
    • uma imagem real de operador/contexto de publicação, ou
    • um módulo denso de escrita/prova com substância específica de artigo, serviço ou credibilidade.
  • Não emita enchimento visual de baixa informação, como retângulos de gradiente pálido, cartões de contexto vazios, trilhos laterais fracos, caixas de placeholder decorativas ou painéis de "contexto em destaque" que carregam quase nenhuma evidência real.
  • Se nenhuma imagem crível estiver disponível, substitua o slot de mídia por um destaque de escrita substancial, pilha de prova editorial ou módulo de evidência do operador, em vez de enviar uma superfície de placeholder decorativa.
  • Quando uma página inicial ou faixa de suporte usar uma composição esquerda-direita, o bloco de texto e o bloco de mídia devem se alinhar como um layout pareado deliberado. Não renderize uma laje de texto alta ao lado de um pequeno azulejo de imagem flutuante com alturas incompatíveis ou linhas de base não relacionadas.
  • Se o layout usar uma imagem lateral, faça dessa imagem um painel ou cartão companheiro adequado, com proporção estável, alinhamento vertical compartilhado e peso visual suficiente para equilibrar a coluna de texto.

Contrato de identidade visual

  • Superfícies de portfólio/blog não devem reutilizar o mesmo sistema visual de sites corporativos, de documentação ou de hub de conteúdo institucional.
  • Prefira uma estética editorial de revista de tecnologia com neutros quentes de papel ou grafite, um acento disciplinado, tipografia legível de formato longo e forte hierarquia de cartões de artigo.
  • Não use como padrão o tema genérico verde-branco de cartão arredondado.
  • A composição dominante deve parecer uma publicação pessoal polida: masthead de perfil, cartões de ensaio, leads de artigo, prova editorial e momentos compactos de contato.

Contrato da rota do blog

  • /blog pode ser um arquivo de primeira classe, mas deve permanecer uma rota de site real com o mesmo cabeçalho, rodapé, sistema CSS e contrato de navegação compartilhados que o resto do site.
  • A primeira passagem padrão de geração do site deve garantir uma página de arquivo forte /blog/index.html, não um conjunto completo de páginas de artigo /blog/{slug}/index.html.
  • Se o arquivo mostrar tópicos de artigo iniciais, mantenha-os como cartões prontos para arquivo, resumos ou entradas de coleção durante a primeira passagem. Não force o fluxo de trabalho principal a finalizar todas as páginas de detalhes antecipadamente.
  • A geração de detalhes do blog é uma etapa separada do fluxo de trabalho. Execute-a após a prontidão para deploy e antes da vinculação de domínio personalizado, ou quando o usuário acionar manualmente a geração de artigo.
  • Quando o blog-detail-fill-workflow dedicado estiver ativo, cada rota /blog/{slug}/ solicitada deve se tornar uma página de detalhes estável, alinhada ao slug, com estrutura real de formato longo: um H1 próprio, uma introdução forte, várias seções H2 substanciais e corpo de texto suficiente para parecer um texto técnico finalizado.
  • Não invente rotas de categoria de arquivo, tag ou índice de autor, a menos que o manifesto confirmado as inclua explicitamente.
  • /blog não deve abrir como uma laje de texto gigante mais um trilho visual vazio ou fraco. Se a rota usar um painel de contexto de arquivo de suporte, esse painel precisa de evidência real de arquivo: posts em destaque, dicas de publicação, temas de leitura ou substância visual própria da rota.
  • Superfícies de arquivo e listagem devem preferir cartões de artigo com imagem-texto quando uma imagem de suporte crível estiver disponível. Não use como padrão blocos apenas de texto no arquivo se a rota já tiver espaço para miniaturas editoriais pareadas ou imagens de prova.
  • Vitrines tipo produto, ledgers de artigo, faixas de escrita em destaque e prateleiras de prova devem preferir cartões integrados de imagem-texto em vez de linhas de texto separadas mais um placeholder visual destacado.

Contrato de shell compartilhado

  • Cabeçalho, ordem de navegação, destinos do rodapé e referências compartilhadas de folha de estilo/script devem permanecer consistentes em todas as rotas /, /blog, /about, /contact e qualquer rota explícita /blog/{slug}/.
  • Para um conjunto compacto de rotas como Home / Blog / About / Contact, os cabeçalhos de desktop e tablet devem renderizar os links principais diretamente. Não deixe um botão textual visível de Menu na navegação de desktop quando os links já couberem em uma linha.
  • Se um gatilho de disclosure for usado para larguras estreitas, ele deve ser apenas para mobile e apoiado por CSS e JavaScript correspondentes. Não envie um cabeçalho onde a alternância seja visível, mas a navegação nunca recolha.
  • Rotas internas podem variar em módulos de abertura e ritmo editorial, mas não devem colapsar o rodapé em uma linha legal plana ou derivar para marcação de shell avulsa.
  • A cópia do shell compartilhado deve permanecer voltada para o visitante. Não exponha notas de implementação, instruções de contagem de artigos, texto de fluxo de trabalho de publicação ou raciocínio do sistema de design na cópia visível.
  • Páginas de detalhes do blog devem herdar o mesmo conjunto de destinos de rodapé compartilhados que a página inicial e o índice do blog.
  • O rodapé deve usar um shell de rodapé estruturado, não uma linha pagefoot nua ou um fluxo plano de âncoras. Forma mínima:
    • uma faixa de rodapé com separação visível do conteúdo principal
    • uma zona de identidade/marca
    • uma zona de navegação/links
    • uma zona de suporte/meta/ações
  • Se o CSS compartilhado definir utilitários de shell de rodapé como site-footer__inner, footer-grid, footer-brand, footer-links, footer-nav, footer-meta, footer-actions, footer-bottom ou classes equivalentes BEM/coluna-de-rodapé, o HTML do rodapé deve usar essas mesmas zonas estruturadas em vez de colapsar em uma única linha inline.
  • O agrupamento do rodapé deve permanecer distinto. Não repita o mesmo conjunto de rotas sob vários cabeçalhos, como "Navegação primária" e "Seções principais"; cada grupo do rodapé precisa de uma função separada.

Exclusões de cópia

  • Não exponha redação de mecânica de rota como "comece com estes três artigos", "esta página coleta", "ordem de leitura" ou "continue para a próxima página".
  • Não exponha rótulos internos de QA ou layout como Layout responsivo, Shell compartilhado, Revisão para desktop e mobile, grupos da página inicial ou sistema visual mantém.
  • Não use enchimento de artigo placeholder, rótulos TODO, lorem ipsum ou comentários abstratos de estratégia de conteúdo na prosa visível dos detalhes do blog.

Preferência de mídia

  • Quando o briefing for um site pessoal técnico, perfil de consultor ou publicação liderada por escrita, prefira imagens reais de contexto de operador/editorial em / e /blog sempre que a rota já reservar espaço visual.
  • Boas correspondências incluem fotografias de espaço de trabalho, mesa de escrita, mesa de reunião, caderno, editorial, pesquisa ou contexto de implementação que reforcem o propósito da rota.
  • Não preencha esses slots com gradientes abstratos, cartões vazios, mosaicos de ícones genéricos ou trilhos de suporte fracos quando uma imagem contextual crível estiver disponível.

Individual skills in this repo

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

Habilidades Relacionadas