Communitygithub.com

GiantClam/shpitto

Contrato de generación específico para sitios web de portafolio personal y blog. Útil para currículums, sitios de creadores, perfiles de consultores y sitios personales centrados en la escritura.

¿Qué es shpitto?

El skill GiantClam/shpitto proporciona un contrato de generación especializado para construir sitios web de portafolio personal y blog, diseñado para individuos, creadores, consultores y perfiles personales impulsados por la escritura. A diferencia de los sitios corporativos, este skill permite que la identidad personal y el punto de vista lideren la página de inicio, tratando el blog como una ruta narrativa de primera clase. La página de inicio debe presentar a la persona, su juicio técnico y generar confianza antes de enrutar a los visitantes al blog, utilizando una secuencia preferida de encabezado de perfil, pilares de experiencia, escritura seleccionada y una llamada a la acción concisa. El skill evita rellenos visuales de baja información, favoreciendo imágenes contextuales reales o módulos densos de prueba de escritura. La identidad visual prefiere una estética de revista de tecnología editorial con tonos cálidos, una tipografía legible y una jerarquía clara de tarjetas de artículo, evitando el tema corporativo genérico. El contrato del blog garantiza una página de archivo sólida en `/blog/index.html` durante el primer pase, con páginas de detalle de artículo generadas en una etapa separada, manteniendo un shell compartido consistente (encabezado, pie de página, navegación) en todas las rutas. Las exclusiones de copia prohíben la jerga de mecánica de ruta, etiquetas internas y texto de relleno, asegurando un contenido pulido y orientado al visitante.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Sitio Web de Portafolio y Blog

Utiliza este skill cuando el sitio represente a un individuo, creador, consultor o perfil personal liderado por la escritura.

Contrato principal

  • La identidad personal y el punto de vista pueden liderar la página de inicio.
  • El blog o la escritura pueden ser una ruta de primera clase y una superficie narrativa.
  • La narrativa, el ritmo editorial y la narración de perfiles están permitidos aquí de maneras que no lo están para corporate-b2b-site.
  • No fuerces las expectativas de la cáscara corporativa empresarial en un sitio genuino de portafolio/blog.

Contrato de la página de inicio

  • La página de inicio debe presentar a la persona nombrada, su criterio técnico y por qué la audiencia debería confiar en su escritura o servicios antes de enrutar a los visitantes a /blog.
  • Trata / como una página de inicio editorial liderada por el perfil, no como un héroe de marketing genérico ni como un directorio de artículos comprimido.
  • Secuencia preferida de la página de inicio:
    • encabezado liderado por el perfil
    • pilares de experiencia o editoriales
    • banda de escritura/prueba seleccionada
    • CTA concisa o tira de contacto
  • No permitas que la página de inicio se lea como un explicador de archivo, una nota de orden de ruta o un panel de mecánicas de "empieza aquí".
  • Si la apertura de la página de inicio o la primera banda de soporte utiliza un espacio visual, ese espacio debe ser:
    • una imagen real de operador/contexto de publicación, o
    • un módulo denso de escritura/prueba con sustancia específica de artículo, servicio o credibilidad.
  • No emitas relleno visual de baja información como rectángulos de gradiente pálido, tarjetas de contexto vacías, rieles laterales débiles, cajas de marcador de posición decorativas o paneles de "contexto destacado" que no contienen casi ninguna evidencia real.
  • Si no hay una imagen creíble disponible, reemplaza el espacio multimedia con un foco de escritura sustancial, una pila de prueba editorial o un módulo de evidencia del operador en lugar de enviar una superficie de marcador de posición decorativa.
  • Cuando una página de inicio o banda de soporte utiliza una composición izquierda-derecha, el bloque de texto y el bloque multimedia deben alinearse como un diseño de par deliberado. No renderices una losa de texto alta junto a un mosaico de imagen pequeño flotante con alturas desiguales o líneas base no relacionadas.
  • Si el diseño utiliza una imagen lateral, haz que esa imagen sea un panel o tarjeta acompañante adecuada con una relación de aspecto estable, alineación vertical compartida y suficiente peso visual para equilibrar la columna de texto.

Contrato de identidad visual

  • Las superficies de portafolio/blog no deben reutilizar el mismo sistema visual que los sitios corporativos, de documentación o de centros de contenido institucionales.
  • Prefiere una estética de revista de tecnología editorial con neutros de papel cálido o grafito, un acento disciplinado, tipografía legible de formato largo y una fuerte jerarquía de tarjetas de artículo.
  • No uses por defecto el tema genérico de tarjetas redondeadas verde-blanco.
  • La composición dominante debe sentirse como una publicación personal pulida: encabezado de perfil, tarjetas de ensayo, leads de artículo, prueba editorial y momentos de contacto compactos.

Contrato de la ruta del blog

  • /blog puede ser un archivo de primera clase, pero debe seguir siendo una ruta real del sitio web con el mismo encabezado, pie de página, sistema CSS y contrato de navegación compartidos que el resto del sitio.
  • El primer pase de generación del sitio web por defecto debe garantizar una página de archivo /blog/index.html sólida, no un conjunto completo de páginas de artículo /blog/{slug}/index.html.
  • Si el archivo muestra temas de artículo iniciales, mantenlos como tarjetas listas para archivo, resúmenes o entradas de colección durante el primer pase. No fuerces que el flujo de trabajo principal termine cada página de detalle de inmediato.
  • La generación de detalle del blog es una etapa de flujo de trabajo separada. Ejecútala después de la preparación para el despliegue y antes de la vinculación de dominio personalizado, o cuando el usuario active manualmente la generación de artículos.
  • Cuando el blog-detail-fill-workflow dedicado esté activo, cada ruta /blog/{slug}/ solicitada debe convertirse en una página de detalle estable y alineada con el slug con estructura real de formato largo: un H1 propio de la ruta, una introducción sólida, múltiples secciones H2 sustanciales y suficiente cuerpo de copia real para leerse como escritura técnica terminada.
  • No inventes rutas de categoría de archivo, etiqueta o índice de autor a menos que el manifiesto confirmado las incluya explícitamente.
  • /blog no debe abrirse como una losa de texto gigante más un riel visual vacío o débil. Si la ruta utiliza un panel de contexto de archivo de soporte, ese panel necesita evidencia de archivo real: publicaciones destacadas, señales de publicación, temas de lectura o sustancia visual propia de la ruta.
  • Las superficies de archivo y listado deben preferir tarjetas de artículo con imagen-texto cuando haya una imagen de soporte creíble disponible. No uses por defecto bloques solo de texto en el archivo si la ruta ya tiene espacio para miniaturas editoriales emparejadas o imágenes de prueba.
  • Las vitrinas tipo producto, los libros de contabilidad de artículos, las tiras de escritura destacada y los estantes de prueba deben preferir tarjetas integradas de imagen-texto sobre filas de texto separadas más un marcador de posición visual independiente.

Contrato de shell compartido

  • El encabezado, el orden de navegación, los destinos del pie de página y las referencias compartidas de hoja de estilo/script deben mantenerse consistentes en /, /blog, /about, /contact y cualquier ruta explícita /blog/{slug}/.
  • Para un conjunto de rutas compacto como Inicio / Blog / Acerca de / Contacto, los encabezados de escritorio y tableta deben renderizar los enlaces principales directamente. No dejes un botón textual visible de Menú en la navegación de escritorio cuando los enlaces ya caben en una línea.
  • Si se utiliza un disparador de divulgación para anchos estrechos, debe ser solo para móvil y estar respaldado por CSS y JavaScript coincidentes. No envíes un encabezado donde la alternancia sea visible pero la navegación nunca se contraiga.
  • Las rutas interiores pueden variar en módulos de apertura y ritmo editorial, pero no deben colapsar el pie de página en una fila legal plana ni derivar en un marcado de shell único.
  • La copia del shell compartido debe permanecer orientada al visitante. No expongas notas de implementación, instrucciones de recuento de artículos, texto de flujo de trabajo de publicación o justificación del sistema de diseño en la copia visible.
  • Las páginas de detalle del blog deben heredar el mismo conjunto de destinos de pie de página compartido que la página de inicio y el índice del blog.
  • El pie de página debe usar un shell de pie de página estructurado, no una fila pagefoot desnuda o una secuencia plana de enlaces. Forma mínima:
    • una banda de pie de página con separación visible del contenido principal
    • una zona de identidad/marca
    • una zona de navegación/enlaces
    • una zona de soporte/meta/acciones
  • Si el CSS compartido define utilidades de shell de pie de página como site-footer__inner, footer-grid, footer-brand, footer-links, footer-nav, footer-meta, footer-actions, footer-bottom, o clases equivalentes BEM/columna de pie de página, el pie de página HTML debe usar esas mismas zonas estructuradas en lugar de colapsar a una sola fila en línea.
  • La agrupación del pie de página debe mantenerse distinta. No repitas el mismo conjunto de rutas bajo múltiples encabezados como Navegación principal y Secciones clave; cada grupo de pie de página necesita un trabajo separado.

Exclusiones de copia

  • No expongas redacción de mecánica de ruta como "empieza con estos tres artículos", "esta página recopila", "orden de lectura" o "continúa a la siguiente página".
  • No expongas etiquetas internas de control de calidad o diseño como Diseño responsivo, Shell compartido, Revisión de escritorio y móvil, grupos de página de inicio o el sistema visual se mantiene.
  • No uses relleno de artículo de marcador de posición, etiquetas TODO, lorem ipsum o comentarios abstractos de estrategia de contenido en la prosa visible de detalle del blog.

Preferencia multimedia

  • Cuando el resumen sea un sitio personal técnico, perfil de consultor o publicación liderada por la escritura, prefiere imágenes de contexto real de operador/editorial en / y /blog siempre que la ruta ya reserve espacio visual.
  • Las buenas coincidencias incluyen fotografía de espacio de trabajo, escritorio de escritura, mesa de reuniones, cuaderno, editorial, investigación o contexto de implementación que refuerce el propósito de la ruta.
  • No llenes esos espacios con gradientes abstractos, tarjetas vacías, mosaicos de iconos genéricos o rieles de soporte débiles cuando haya una imagen contextual creíble disponible.

Individual skills in this repo

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

Skills relacionados