Communitygithub.com

lishu-portfolio-gen

Genera un sitio web de portafolio de estilo estudio chino (lista horizontal + hover con miniatura, tipografía artística Alimama DaoLiTi, tema claro/oscuro, páginas de detalle con enrutamiento hash). Acepta una descripción en lenguaje natural del estudio y produce un solo archivo HTML funcional.

¿Qué es lishu-portfolio-gen?

Este skill genera un sitio web de portafolio de una sola página, con un estilo visual chino tradicional y moderno, adecuado para estudios de diseño tipográfico, encuadernación, artesanía, té, cerámica, etc. Se distingue por su diseño horizontal de filas de texto, donde al pasar el mouse sobre un nombre de obra aparece una miniatura grande a la derecha, y al hacer clic se navega a una página de detalle con galería, descripción y especificaciones. Utiliza la tipografía artística 'Alimama DaoLiTi' (cargada vía CDN) y permite cambiar entre modo claro y oscuro. El resultado es un solo archivo HTML que funciona tanto en Claude Code (escribe en ~/Desktop) como en chats en línea (GLM, etc., mostrando el HTML en línea). Las frases de activación incluyen '做个中式工作室作品集', '做个隶书作品集', 'lishu-portfolio-gen ...', '做个白屋风格的作品集', o cuando el usuario arrastra la carpeta del skill al chat pidiendo un sitio estilo atelier.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/antilsabh789-pixel/kabaddi-pro/tree/HEAD/.migration-backup/skills/design/design-templates/portfolio-detail

Preguntar en tu IA favorita

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

Documentación

portfolio-detail — Estudio chino / Portafolio en estilo lishu (con página de detalle secundaria)

Característica en una frase

Filas de texto horizontal + al pasar el mouse aparece una imagen grande a la derecha + tipografía artística Alimama DaoLiTi + blanco y negro puro + light/dark + enrutamiento hash para página de detalle + vista dual lista/galería.

Diferencias con otros skills de portafolio

skillModo principalIdeal para
portfolio-genLienzo de arrastre infinito + mosaicoFotógrafos / diseñadores gráficos que muestran muestras
portfolio-museum-genCarrusel hero + tarjeta grande + flujo de cascada + página de detalle (sensación de curaduría visual)Artistas de video / imagen / instalación
industrial-archive-genPortada de página negra + barra lateral de archivo + industrial nórdicoProductos físicos / artículos / hardware
lishu-portfolio-genFilas de texto horizontal + hover muestra miniatura a la derecha + letras grandes en lishu + contención chinaEncuadernación / tipografía / artesanía / estudio chino

Si el proyecto del usuario es «libro / tipografía / exhibición / naturaleza muerta / hierbas chinas / té / cerámica / madera / papel / incienso» — usa este skill.

Cuándo activarlo

El usuario dice:

  • "Haz un portafolio de estilo chino / oriental / clásico"
  • "Haz un sitio web en estilo caligráfico lishu / página de estudio"
  • "Haz un portafolio de estilo casa blanca" / "Haz un sitio web de lista horizontal como Gurgel D'Alfonso"
  • "lishu-portfolio-gen ..."

Y proporciona:

  • Descripción del estudio (obligatorio): nombre, director, ciudad, disciplina, títulos e historia de algunas obras
  • Imágenes de obras (opcional): URL / subida / ruta. Funciona sin ellas (usa picsum como placeholder)

Si el usuario no da títulos de obras → preguntar al menos qué obras quiere mostrar. Si el usuario solo da títulos sin detalle → generar uno mismo: cada obra recibe 1 lead + 3 párrafos de prosa + 6-8 líneas de specs + 3-6 imágenes de picsum + algunos créditos. El tono debe coincidir con el tipo de obra (libro → encuadernación / letra → tipografía / objeto → naturaleza muerta / exhibición → visual de exposición).

Dos modos de ejecución

Modo A · Claude Code / Local (con sistema de archivos)

  • Usa Bash para listar carpetas, sips para obtener ancho y alto de cada imagen
  • Salida: ~/Desktop/{slug}-portfolio.html (archivo único, todas las imágenes por URL)
  • Si el usuario da imágenes locales: copiar a ~/Desktop/{slug}-portfolio-images/ y cambiar src a ruta relativa

Modo B · GLM / Chat en línea (sin sistema de archivos)

  • El usuario arrastra un zip; al extraerlo se ven 4 archivos
  • Solo se genera una cadena HTML completa, envuelta en un bloque de código ```html
  • Si el usuario sube imágenes pero no da URL → usar https://picsum.photos/id/{id}/{w}/{h} como placeholder (con IDs existentes conocidos)
  • No intentar acceder a archivos locales, no sugerir comandos de terminal

Decisión: si no puedes Read para ver imágenes locales → ir por modo B por defecto.

Distribución de archivos

ArchivoRolCómo usarlo
reference.htmlReferencia completa — Casa Blanca BAIWU 6 obrasVer: redacción de elementos de lista, tono de prosa, vocabulario de specs, densidad de campos JSON
template.htmlEsqueleto vacío — mismo CSS/JS/sistema de enrutamiento, 2 ejemplos + 20 marcas SWAPModificar sobre él, generar el HTML final
README.mdInstrucciones para el usuarioEl modelo no necesita verlo
SKILL.mdFlujo de trabajo para el modelo (este archivo)Lectura obligatoria

Regla central: todos los cambios se basan en template.html; aprender cómo escribir (tono, número de palabras, etiquetas) de reference.html, pero no copiar contenido específico.

Pasos de trabajo

1. Leer ambos HTML

  • Leer primero reference.html para entender "cómo se ve completo" (especialmente la densidad de campos del JSON works-data y el tono de la prosa)
  • Luego leer template.html para encontrar las 20 posiciones SWAP

No modificar JS / No modificar CSS / No modificar el sistema de enrutamiento de páginas de detalle / No modificar la importación de fuentes. Los SWAP están solo en el texto HTML y los datos JSON.

2. Extraer información de la entrada del usuario

Extraer:

  • ATELIER_NAME_ZH — Nombre chino del estudio (2-4 caracteres, ideal: «白屋», «素园», «墨记», «青庐», «拙轩»)
  • PINYIN — Pinyin (5-6 letras, mayúsculas: BAIWU / SUYUAN / MOJI)
  • CHAR — Carácter para el logo (normalmente el primer carácter del nombre: 白 / 素 / 墨 / 青 / 拙)
  • CITY — Ciudad
  • DIRECTOR_ZH / DIRECTOR_EN — Nombre del director + pinyin
  • DISCIPLINE — 3 palabras de disciplina ("Encuadernación · Tipografía · Naturaleza muerta")
  • TAGLINE — Una frase de posicionamiento (20-40 caracteres, tono caligráfico)
  • YEAR_FOUNDED — Año de fundación (se puede usar año cíclico: 乙未冬 / 甲辰春)

Para cada obra extraer:

  • slug — ID de URL, minúsculas con guiones (kong-shan-ji / wu-ming-shu)
  • title_zh — Título en chino (2-5 caracteres, cuanto más conciso mejor)
  • title_en — Subtítulo en inglés (estilo título de libro: An Anthology of Empty Mountains)
  • year — Año o año cíclico (甲辰 / 2024 / 2025 / 乙巳 / 2025)
  • tag — Categoría superior, entre corchetes: [ Poesía · Diseño de encuadernación ] / [ Diseño tipográfico · Herbario chino ]
  • cover — URL de la imagen grande de la página de detalle
  • location (línea de lista) — Ciudad, año · Técnica/Especificaciones (aparece al hacer hover)
  • meta — 4 pares clave-valor (resumen de 4 columnas en la página de detalle)
  • lead — 30-70 caracteres de apertura, se puede usar <em>palabra clave</em> para enfatizar
  • prose — 3-4 párrafos de prosa, cada uno de 80-150 caracteres
  • specs — 6-10 líneas de tabla de especificaciones (formato/papel/encuadernación/tipografía/tirada/impresión/técnica/precio, etc.)
  • gallery — 3-6 imágenes, layout una de tres: g-wide / g-half / g-third
  • credits — 4-7 pares de cargo/nombre

Si el usuario solo da una frase / no da historia → inventar: según el título y tipo de obra, escribir lead y prosa que encajen con el tono. El tono debe seguir el de reference.html — sin lenguaje de marketing, con sensación de "texto de museo + notas de taller" (contención, concreción, lentitud, huellas de artesanía).

3. Listar obras + medir dimensiones (solo modo A)

ls -la "{works_path}"
sips -g pixelWidth -g pixelHeight "{works_path}/{file}" 2>/dev/null

Obtener (nombre_archivo, w, h, aspecto) de cada imagen. Priorizar imágenes verticales como miniaturas de lista (contenedor 4:3, las verticales lucen mejor).

4. Reemplazar 20 SWAP

SWAPPosiciónContenido
1<title>{ATELIER_NAME} {PINYIN} — {DIRECTOR} Portfolio / Studio
2meta descriptionUna frase de descripción del sitio
3Carácter de cortinaPrimer carácter del nombre del estudio (ej. «白»)
4Carácter dentro del SVG del logoIgual que SWAP-3
5Pinyin dentro del SVG del logo{PINYIN} en mayúsculas
6li de navegación principalNormalmente 3: Obras / Sobre / Contacto
7Nombre chino en brand-block{ATELIER_NAME} con espacios (ej. 白&nbsp;&nbsp;屋)
8Inglés en brand-block{PINYIN} Studio · {CITY}
9TaglineUna frase de posicionamiento en caligrafía, 20-40 caracteres, se puede usar <br> para saltos de línea
10N elementos de listaCada <a class="item" href="#work/{slug}"> contiene num/project-name/en-name/location/photo-thumb
11N elementos de galeríaLas mismas N obras, en una cuadrícula más compacta — slug debe coincidir con el de la lista
12Título de "Sobre"Ac&nbsp;er&nbsp;ca&nbsp;de&nbsp;{name}<span class="en">About</span>
13Párrafos de "Sobre"1-3 párrafos en caligrafía (orígenes / director / filosofía de diseño), cada uno de 60-120 caracteres
14Tabla de datos de "Sobre"4-6 elementos li (Founded/Location/Discipline/Director/Hours)
15Título de "Contacto"Es&nbsp;cri&nbsp;be&nbsp;nos<span class="en">Get in Touch</span>
16Párrafos de "Contacto"1-2 párrafos invitando a escribir + promesa de tiempo de respuesta
17Tabla de datos de "Contacto"4-6 elementos (Email/Phone/Address/Instagram/WeChat Official Account)
18Crédito rotativoSite by {WHO} (normalmente el nombre del estudio)
19Tres bloques de footer© / ICP / Enlaces sociales
20JSON works-dataDatos completos de detalle de N obras (¡clave!)

5. Escribir el JSON works-data (el paso más importante)

Cada obra debe tener una entrada en el array JSON, el slug debe coincidir exactamente con el #work/SLUG en los href de los elementos de lista/galería.

Campos JSON:

{
  "slug": "kong-shan-ji",
  "title_zh": "空山集",
  "title_en": "An Anthology of Empty Mountains",
  "year": "甲辰 / 2024",
  "tag": "[ Poesía · Diseño de encuadernación ]",
  "cover": "https://picsum.photos/id/143/1800/1100",
  "meta": [
    {"label": "Tipo / Type", "value": "Encuadernación de poesía"},
    {"label": "Año / Year", "value": "2024"},
    {"label": "Edición / Edition", "value": "Primera tirada 320 ejemplares"},
    {"label": "Formato / Format", "value": "130 × 195 mm"}
  ],
  "lead": "Treinta y seis poemas sobre montañas. Queríamos hacer un libro que, al abrirlo, el lector escuchara primero el <em>sonido del viento</em> antes de leer las palabras.",
  "prose": [
    "Párrafo uno: origen de los poemas / contexto de diseño. 80-150 caracteres.",
    "Párrafo dos: decisiones clave durante la producción — tipografía, papel, encuadernación.",
    "Párrafo tres: resultado final / sensación que deja al lector."
  ],
  "specs": [
    ["Formato / Format", "130 × 195 mm"],
    ["Páginas / Pages", "144 páginas"],
    ["Papel / Paper", "Papel de algodón natural 90gsm"],
    ["Encuadernación / Binding", "Encuadernación cosida a cuatro agujeros"],
    ["Tipografía / Typeface", "Song antigua (títulos) · Kai (cuerpo)"],
    ["Impresión / Printing", "Impresión monocromática en relieve"],
    ["Tirada / Edition", "Primera tirada 320 ejemplares"],
    ["Precio / Price", "¥ 388"]
  ],
  "gallery": [
    {"src": "...", "layout": "g-wide", "caption": "Portada"},
    {"src": "...", "layout": "g-half"},
    {"src": "...", "layout": "g-half"},
    {"src": "...", "layout": "g-third"},
    {"src": "...", "layout": "g-third"},
    {"src": "...", "layout": "g-third"}
  ],
  "credits": [
    ["Diseño / Design", "Zhou Mobai"],
    ["Encuadernación manual / Binding", "Chen Sushi (Hangzhou · Taller de encuadernación)"]
  ]
}

Errores comunes del JSON ⚠️:

  • En la prosa china, usar comillas → deben ser comillas completas 「...」 o "..." (U+201C / U+201D), no ASCII " (rompe el JSON)
  • No poner saltos de línea reales en cadenas JSON; para cambiar de párrafo, añadir un elemento más al array prose
  • <em>palabra</em> en el lead se escribe directamente con etiquetas HTML — se renderiza como innerHTML
  • El layout de la galería debe ser uno de tres: g-wide (ocupa todo) / g-half (ocupa la mitad) / g-third (ocupa 1/3)

6. Selección de fuentes de imágenes

  • Placeholder picsum: usar forma id/X en lugar de seed/X (más estable). IDs conocidos que funcionan: 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200
  • Para cover/gallery de una misma obra, usar IDs consecutivos para crear una gama de colores coherente
  • No usar parámetro ?grayscale (el usuario quiere imágenes en color)

7. Inspiración para nombres de estudio chinos (si el usuario no da uno)

Si el usuario pide "inventa uno" → elegir 2 caracteres con aire antiguo:

  • Categoría objetos: 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
  • Categoría caligrafía: 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
  • Evitar palabras funcionales como "工作室 / 设计 / Studio" — que el nombre sea poético por sí mismo

8. Soporte para video

Si la portada de la obra es .mp4 / .webm / .mov, la página de detalle usará automáticamente <video autoplay muted loop> en lugar de <img>. El modelo solo debe dar la ruta del video en la URL del cover.

9. Reporte

Modo A: Reporte de una frase.

Generado ~/Desktop/baiwu-portfolio.html — 6 obras, pasa el mouse sobre las filas para ver miniaturas, haz clic para entrar a la página de detalle. Light/Dark en la esquina inferior izquierda, lista/galería centrado en la parte superior.

Modo B: Dar directamente el bloque de código HTML completo + una línea de explicación.

Guarda el bloque de arriba como index.html y haz doble clic para abrirlo. Mueve el mouse sobre cualquier nombre de obra para ver la miniatura que aparece a la derecha; haz clic para ir a la página de detalle. Para cambiar las imágenes, reemplaza las URLs de picsum con las tuyas.

Obligatorio (no se puede modificar)

  • Importación de fuentes: @font-face cargando la URL woff2 de Alimama DaoLiTi (no cambiar la fuente)
  • Sistema de variables CSS: temas claro/oscuro duales
  • Todo el JS: toggle de tema, toggle de modo de vista, interacción hover-row, crédito rotativo, enrutamiento hash de página de detalle applyRoute(), renderDetail()
  • El nodo <script id="works-data"> debe permanecer
  • <main id="detail-root"> debe permanecer (punto de montaje de la página de detalle)
  • Sistema de estados body[data-view="home/detail"] y body[data-mode="list/gallery"]
  • Cinco elementos posicionados fijos: #logo / #main-menu / .theme-toggle / #project-view / #svp-credit

Errores comunes (lista rápida)

  • Slug no coincide: elemento de lista #work/kong-shan-ji ↔ elemento de galería #work/kong-shan-ji ↔ JSON "slug": "kong-shan-ji" — los tres deben ser exactamente iguales
  • Comillas en JSON: las comillas en contenido chino deben ser completas «» o "...", no ASCII "
  • Demasiadas imágenes en galería: máximo 6 por obra; más desordena el diseño
  • Prosa demasiado larga: cada párrafo 80-150 caracteres; más de 200 afecta la experiencia de lectura
  • Lista y galería desincronizadas: deben contener el mismo conjunto de obras (uno a uno)
  • Seed de picsum: usar id/X no seed/X para evitar que un ID aleatorio apunte a una imagen eliminada
  • Menos de 3 obras: funciona, mínimo 2
  • Más de 8 obras: dividir en dos lotes; demasiadas filas alargan la página
  • Primera letra en detalle: .detail__prose p:first-of-type::first-letter usa la fuente DaoLiTi — el primer párrafo debe comenzar con texto chino (no con <em> o inglés)
  • Eliminar color de picsum: las imágenes deben ser a color, no agregar filter: grayscale() en CSS

Individual skills in this repo

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

Skills relacionados