Communitygithub.com

ShaysFrame/meu

Sistema de portfólio pessoal e marca para Shay (ShaysFrame). Use esta skill ao construir, projetar ou melhorar qualquer parte do site pessoal de portfólio de Shay, blog, páginas de projetos, página de currículo ou qualquer conteúdo web de autopromoção. Acione com: "portfólio", "meu site", "página de projeto", "sobre mim", "página de currículo", "seção hero", "marca pessoal", "shay.pub".

O que é meu?

Esta skill define o sistema completo de portfólio pessoal e marca para M. Mahafuj Rahman (conhecido como Shay online, GitHub: ShaysFrame). Ela descreve uma abordagem editorial, de alto contraste, liderada pela tipografia, projetada para causar uma impressão instantânea. A skill especifica uma paleta de cores monocromática rigorosa, regras de tipografia (serifa para hero, sans-serif limpa para UI, mono para código), e uma filosofia de movimento em camadas que prioriza CSS puro para performance, com animações de scroll e um único elemento "uau" no hero. O portfólio é construído com Astro (SSG), TypeScript, CSS custom properties e React/Preact para ilhas interativas, implantado na Vercel. A skill prioriza a exibição de projetos como Qifa, Open RTMS e XueHanYu, orienta a estrutura do site e o tom de escrita, e enfatiza uma narrativa direta e confiante, evitando clichês. Ela suporta as plataformas Claude Code, Cursor e Codex, sendo acionada por termos como "portfólio", "meu site" e "sobre mim".

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ShaysFrame/my/tree/HEAD/tools/portfolio-skill

Perguntar na sua IA favorita

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

Documentação

Portfólio de M. MAHAFUJ RAHMAN — Sistema de Marca e Construção

Você está construindo o portfólio pessoal de M. Mahafuj Rahman, um desenvolvedor full-stack com uma ampla gama de projetos entregues em mobile, web, backend, IoT e ML. O portfólio deve comunicar profundidade, alcance e ofício — não apenas listar tecnologias.


Identidade

Nome: M. MAHAFUJ RAHMAN (conhecido como Shay online) GitHub: ShaysFrame Site: shay.pub
Identidade de stack: Generalista full-stack — Flutter, Vue, Astro, React, Django, PHP, Docker, YOLO/CV
Objetivo de carreira: Conseguir um papel em uma empresa de tecnologia de ponta demonstrando trabalho real e entregue


Filosofia de Design

Estética: Editorial. Alto contraste. Liderada pela tipografia. Instantaneamente chama a atenção.
Tom: Limpo e elegante — como uma capa de revista, não uma landing page de SaaS.
Princípio guia: Cada elemento ou chama a atenção ou é removido.

Paleta de Cores

--color-bg:        #0a0a0a   /* fundo quase preto */
--color-surface:   #111111   /* cartões, painéis */
--color-border:    #222222   /* divisores sutis */
--color-text:      #f5f5f5   /* texto primário — off-white, não branco puro agressivo */
--color-muted:     #777777   /* texto secundário/metadados */
--color-accent:    #ffffff   /* branco puro — usado com moderação para máximo contraste */
--color-highlight: #e8e8e8   /* estados de hover, itens selecionados */

Sem acentos de cor. Sem gradientes. Preto, branco e contraste fazem todo o trabalho.

Tipografia

  • Display / Hero: Uma única fonte serifa ou grotesca de alto contraste em negrito. Sugestões: Playfair Display, Editorial New, PP Neue Montreal, Instrument Serif
  • Corpo / UI: Sans-serif geométrica limpa. Inter, DM Sans, ou Geist
  • Código: JetBrains Mono ou Geist Mono
  • Regra: Menos pesos de fonte, mais tamanhos intencionais. Use escala, não cor, para criar hierarquia.

Movimento e Interação

Filosofia: O movimento deve parecer inevitável, não decorativo. Cada animação responde "por que isso se move?" — para direcionar a atenção, sinalizar estado ou recompensar uma rolagem.

Camada 1 — CSS (sempre, sem dependências)

  • Transições de página: usar <ViewTransitions /> nativo do Astro — custo JS zero
  • Estados de hover: mudanças de opacidade, revelações de sublinhado, escala sutil (1.0 → 1.02)
  • Estados de foco: anel visível usando --color-accent
  • Entrada: @keyframes CSS fadeUp para conteúdo acima da dobra

Camada 2 — Animação baseada em scroll (CSS-first)

  • Usar animation-timeline: scroll() nativo do CSS onde o navegador suportar
  • Fallback: IntersectionObserver em um utilitário .ts pequeno — sem necessidade de biblioteca
  • Cartões de projeto: entrada escalonada fade + translateY(24px → 0) ao entrarem na viewport
  • Títulos de seção: deslizar da esquerda ao scroll

Camada 3 — Elemento "uau" do Hero (um, e apenas um)

  • O hero recebe UM efeito de movimento exclusivo. Opções em ordem de preferência:
    1. Revelação escalonada de letras/palavras — nome do hero anima caractere por caractere (apenas CSS)
    2. Overlay de ruído/grão — textura CSS animada sobre o fundo escuro (apenas CSS)
    3. Inclinação 3D sutil — cartões de projeto inclinam levemente ao mover o mouse (Vanilla JS, ~15 linhas)
    4. Three.js / React Three Fiber — apenas se um ativo 3D específico for necessário (ex.: logotipo geométrico rotativo). Use as skills 3D-Animation-Creator ou 3D-Website-Asset-Generator para gerar o ativo separadamente, depois incorpore como um único componente isolado.

O que nunca fazer

  • Fundos Three.js em tela cheia (mata a performance, distrai do conteúdo)
  • Animações em loop em qualquer lugar exceto no hero
  • Física de mola elástica (tom errado para estética editorial)
  • Parallax scrolling em texto
  • Movimento só porque um tutorial usou

Estrutura do Site

/                  → Hero + teaser de projetos em destaque + breve introdução
/about             → Quem é Shay, histórico, filosofia, visão geral de habilidades
/projects          → Grade de todos os projetos com tags de stack e descrições curtas
/projects/[slug]   → Mergulho profundo no projeto individual (problema, solução, stack, links, capturas de tela)
/resume            → Visualização de currículo inline + link para PDF para download
/blog              → Lista de posts do blog (já existe no Astro)
/blog/[slug]       → Post individual (já existe)

Stack Tecnológica

  • Framework: Astro (SSG, markdown-first, zero JS por padrão, SEO excelente)
  • Linguagem de componentes: Componentes Astro + React/Preact (.tsx) para ilhas interativas
  • Linguagem: TypeScript em todos os lugares — .ts, .tsx, .astro com frontmatter tipado. Nunca .js ou .jsx
  • Estilização: Propriedades customizadas CSS (sem Tailwind a menos que o usuário solicite especificamente)
  • Implantação: Vercel
  • Conteúdo: Coleções de Conteúdo Astro para posts do blog e projetos

Prioridade de Exibição de Projetos

Ao construir páginas de projeto, priorize estes projetos nesta ordem (mais impressionante primeiro):

  1. Qifa — ecossistema multi-app (cliente, loja, escritório, Docker, dashboard de logging customizado, ChatWoot)
  2. Open RTMS — sistema em tempo real com detecção facial YOLO v8n (ângulo de ML é raro e impressionante)
  3. XueHanYu — full-stack (Vue + Django), plataforma de aprendizado de chinês
  4. NoorConnect — app + backend + firmware (IoT/embarcado é raro para desenvolvedores web)
  5. Jidian Daojia — Flutter + PHP + uniapp, multiplataforma
  6. LittleLemon — Capstone do Certificado Profissional da Meta (trabalho credenciado)

Para cada página de projeto, estruture o conteúdo como:

  1. Frase de gancho única (qual problema resolve, não qual tecnologia usa)
  2. Badges de stack
  3. O desafio / o que o tornou interessante
  4. Decisões principais tomadas
  5. Links (GitHub, demonstração ao vivo se disponível)

Tom de Escrita

  • Direto. Confiante. Sem enrolação.
  • Primeira pessoa quando apropriado ("Construí...", "Escolhi... porque...")
  • Evitar: "apaixonado por", "automotivado", "orientado a resultados", "alavancou sinergias"
  • Especificidades técnicas > afirmações vagas. Diga "construiu um pipeline de detecção facial em tempo real usando YOLO v8n", não "trabalhou em projetos de visão computacional"

Diretrizes de Componentes

Ao gerar componentes Astro para este portfólio:

  • Estilo de exportação padrão: arquivos .astro com frontmatter ---
  • Use propriedades customizadas CSS da paleta acima
  • Design responsivo mobile-first
  • HTML semântico (uso adequado de <article>, <section>, <nav>, <main>)
  • Sem estilos inline exceto para valores dinâmicos
  • Animações via CSS — keyframes em global.css ou blocos <style> com escopo
  • Ilhas interativas: use diretiva client:visible para que JS carregue apenas quando necessário

O Que Evitar

  • Texto de hero genérico como "Oi, sou um desenvolvedor que adora programar"
  • Gradientes roxos, bordas arredondadas em tudo, botões CTA azuis
  • Layouts poluídos — abrace o espaço branco (ou preto)
  • Listar toda tecnologia que você tocou sem contexto
  • Texto que parece um CV; isto é uma narrativa, não uma lista

Habilidades Relacionadas