portfolio-detail — Estudio chino / Portafolio en lishu (con página de detalle secundaria)
Característica principal
Filas de texto horizontal + al pasar el mouse aparece una imagen grande a la derecha + letras artísticas grandes en Alimama DaoLiTi + blanco y negro sólido + light/dark + enrutamiento por hash para páginas de detalle + vista dual de lista/álbum.
Diferencias con otros skills de portafolio
| skill | Modo principal | Para quién es |
|---|---|---|
portfolio-gen | Lienzo de arrastre infinito + mosaico | Fotógrafos / diseñadores gráficos para mostrar muestras |
portfolio-museum-gen | Carrusel hero + tarjetas grandes + cascada + página de detalle (sensación curatorial de video) | Artistas de video / instalación / instalación |
industrial-archive-gen | Portada de página negra con marco + archivo lateral + nórdico industrial | Productos físicos / objetos / hardware |
lishu-portfolio-gen | Filas de texto horizontal + miniatura a la derecha al pasar el mouse + letras grandes en lishu + contención china | Encuadernación / tipografía / artesanía / estudio chino |
Si el proyecto del usuario es del tipo «libro / tipografía / exposición / naturaleza muerta / hierbas chinas / té / cerámica / madera / papel / incienso» y necesita una elegancia contenida y clásica — usa este skill.
Cuándo activarlo
El usuario dice:
- "Haz un portafolio de estilo chino / oriental / clásico"
- "Haz un sitio web con estilo lishu / página de estudio"
- "Haz un portafolio estilo Casa Blanca" / "Haz un sitio web de lista horizontal como el de Gurgel D'Alfonso"
- "lishu-portfolio-gen ..."
Y proporciona:
- Descripción del estudio (obligatorio): nombre, director, ciudad, disciplina, títulos e historias de algunas obras.
- Imágenes de las obras (opcional): URL / subida / ruta de archivo. Funciona sin ellas (usa picsum como placeholder).
Si el usuario no da ningún título de obra → debes preguntar al menos qué obras se van a mostrar. Si el usuario solo da títulos sin detalles → debes crearlos: para cada obra genera 1 lead + 3 párrafos de prosa + 6-8 líneas de especificaciones + 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 / exposición → exposición visual).
Dos modos de funcionamiento
Modo A · Claude Code / Local (con sistema de archivos)
- Usa
Bashpara listar carpetas,sipspara obtener ancho y alto de cada imagen. - Salida:
~/Desktop/{slug}-portfolio.html(un solo archivo, todas las imágenes vía URL). - Si el usuario da imágenes locales: cópialas a
~/Desktop/{slug}-portfolio-images/y cambia src a ruta relativa.
Modo B · GLM / Chat online (sin sistema de archivos)
- El usuario arrastra un zip que, al descomprimirse, contiene 4 archivos.
- Solo genera una cadena HTML completa, envuelta en un bloque de código
```html. - Si el usuario sube imágenes pero no da URL → usa
https://picsum.photos/id/{id}/{w}/{h}como placeholder (con IDs que existan). - No intentes acceder a archivos locales ni sugieras comandos de terminal.
Regla: si no puedes leer imágenes locales → por defecto usar modo B.
Distribución de archivos
| Archivo | Rol | Cómo usarlo |
|---|---|---|
reference.html | Ejemplo completo de referencia — BAIWU con 6 obras | Mira: la redacción de los elementos de lista, el tono de la prosa, el vocabulario de las especificaciones, la densidad de campos JSON |
template.html | Esqueleto vacío — mismo sistema CSS/JS/enrutamiento, 2 ejemplos + 20 marcas SWAP | Modifícalo para generar el HTML final |
README.md | Instrucciones de uso para el usuario | El modelo no necesita leerlo |
SKILL.md | Flujo de trabajo para el modelo (este archivo) | Lectura obligatoria |
Regla fundamental: todos los cambios se basan en template.html; aprende cómo escribir de reference.html (tono, extensión, uso de etiquetas), pero no copies el contenido específico.
Pasos de trabajo
1. Lee los dos HTML
- Primero lee
reference.htmlpara entender "cómo se ve cuando está completo" (especialmente la densidad de campos JSON y el tono de la prosa). - Luego lee
template.htmlpara encontrar las 20 marcas SWAP.
No modifiques JS / no modifiques CSS / no modifiques el sistema de enrutamiento por hash de la página de detalle / no modifiques la importación de la fuente. Los SWAP están solo en el texto HTML y en los datos JSON.
2. Analiza la entrada del usuario y extrae información
Extrae:
- ATELIER_NAME_ZH — Nombre del estudio en chino (2-4 caracteres ideal, por ejemplo «白屋» «素园» «墨记» «青庐» «拙轩»)
- PINYIN — Pinyin (5-6 letras inglesas, MAYÚSCULAS: BAIWU / SUYUAN / MOJI)
- CHAR — Carácter único para el logo (generalmente el primer carácter del nombre del estudio: 白 / 素 / 墨 / 青 / 拙)
- 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 de letra kaishu)
- YEAR_FOUNDED — Año de fundación (puede usar el ciclo sexagenario: 乙未冬 / 甲辰春)
Para cada obra extrae:
- slug — ID de URL, en minúsculas con guiones (ej.
kong-shan-ji/wu-ming-shu) - title_zh — Título en chino (2-5 caracteres ideal, cuanto más conciso, más estilo)
- title_en — Subtítulo en inglés (estilo de comillas:
An Anthology of Empty Mountains) - year — Año o ciclo sexagenario (
甲辰 / 2024/2025/乙巳 / 2025) - tag — Categoría superior, entre corchetes, ej.
[ 诗集 · 装帧设计 ]/[ 字体设计 · 中草药图谱 ] - cover — URL de la imagen grande de la página de detalle
- location en la fila de lista —
Ciudad, año · técnica/especificación(aparece al pasar el mouse) - meta — 4 pares clave-valor (resumen de página de detalle en 4 columnas)
- lead — 30-70 caracteres de texto inicial grande, puede usar
<em>palabras clave</em>para enfatizar una parte - 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, diseño a elegir entre tres:
g-wide/g-half/g-third - credits — 4-7 pares de posición/nombre
Si el usuario solo da una frase / no da historia → invéntala: basada en el título y tipo de obra, escribe un lead y una prosa que se ajusten al tono de la obra. El tono debe seguir el de reference.html — nada de lenguaje de marketing, sino una sensación de «texto de museo + apuntes de taller» (contenido, concreto, pausado, con marcas de artesanía).
3. Lista las obras y obtén sus dimensiones (solo modo A)
ls -la "{works_path}"
sips -g pixelWidth -g pixelHeight "{works_path}/{file}" 2>/dev/null
Obtén para cada imagen (filename, w, h, aspect). Prioriza imágenes verticales para las miniaturas de lista (contenedor 4:3, las verticales se ven mejor).
4. Reemplaza los 20 SWAP
| SWAP | Ubicación | Contenido |
|---|---|---|
| 1 | <title> | {ATELIER_NAME} {PINYIN} — {DIRECTOR} Portafolio / Studio |
| 2 | meta description | Una breve descripción del sitio |
| 3 | Carácter único del telón | Primer carácter del nombre del estudio (ej. «白») |
| 4 | Carácter único dentro del SVG del logo | Igual que SWAP-3 |
| 5 | Pinyin dentro del SVG del logo | {PINYIN} en MAYÚSCULAS |
| 6 | Lista de navegación principal | Generalmente 3 elementos: Obras / Acerca de / Contacto |
| 7 | Nombre chino del bloque de marca | {ATELIER_NAME} con espacios entre caracteres (ej. 白 屋) |
| 8 | Inglés del bloque de marca | {PINYIN} Studio · {CITY} |
| 9 | Tagline | Una frase de posicionamiento en kaishu, 20-40 caracteres, puede usar <br> para saltos de línea |
| 10 | N elementos de lista | Cada <a class="item" href="#work/{slug}"> que incluye num/project-name/en-name/location/photo-thumb |
| 11 | N elementos de galería | Las mismas N obras, en una cuadrícula más compacta — el slug debe coincidir con el de la lista |
| 12 | Título de Acerca de | Ac er ca de {name}<span class="en">About</span> |
| 13 | Párrafos de Acerca de | 1-3 párrafos en kaishu (contexto de fundación / director / filosofía de diseño), cada uno de 60-120 caracteres |
| 14 | Tabla de hechos de Acerca de | 4-6 elementos li (Año de fundación/Ubicación/Disciplina/Director/Horario) |
| 15 | Título de Contacto | Con tac to<span class="en">Get in Touch</span> |
| 16 | Párrafos de Contacto | 1-2 párrafos invitando a escribir + promesa de tiempo de respuesta |
| 17 | Tabla de hechos de Contacto | 4-6 elementos (E-mail/Phone/Address/Instagram/公众号) |
| 18 | Crédito rotativo | Sitio por {WHO} (generalmente el nombre del estudio) |
| 19 | Pie de página: tres bloques | © / ICP / enlaces a redes sociales |
| 20 | JSON de datos de obras | Datos completos de N obras (¡clave!) |
5. Escribe el JSON de datos de obras (el paso más importante)
Cada obra debe tener una entrada en el array JSON, el slug debe coincidir exactamente con el href="#work/SLUG" de las tarjetas de lista/galería.
Campos JSON:
{
"slug": "kong-shan-ji",
"title_zh": "空山集",
"title_en": "An Anthology of Empty Mountains",
"year": "甲辰 / 2024",
"tag": "[ 诗集 · 装帧设计 ]",
"cover": "https://picsum.photos/id/143/1800/1100",
"meta": [
{"label": "Tipo / 类型", "value": "Encuadernación de poemario"},
{"label": "Año / 年份", "value": "2024"},
{"label": "Tirada / 印量", "value": "Primera tirada 320 ejemplares"},
{"label": "Formato / 开本", "value": "130 × 195 mm"}
],
"lead": "Treinta y seis poemas sobre montañas. Queríamos hacer un libro que, al abrirlo, el lector primero escuchara<em> el viento</em> y luego leyera 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, elección de encuadernación.",
"Párrafo tres: presentación final / sensación para el lector."
],
"specs": [
["Formato / Format", "130 × 195 mm"],
["Páginas / Pages", "144 páginas"],
["Papel / Paper", "Papel de algodón natural 90 g/m²"],
["Encuadernación / Binding", "Cosido en cuatro cuadernillos"],
["Tipografía / Typeface", "Laosong (títulos) · Kaishu (cuerpo)"],
["Impresión / Printing", "Impresión tipográfica a un color"],
["Tirada / Edition", "Primera tirada 320 ejemplares"],
["Precio / Price", "¥ 388"]
],
"gallery": [
{"src": "...", "layout": "g-wide", "caption": "Cubierta"},
{"src": "...", "layout": "g-half"},
{"src": "...", "layout": "g-half"},
{"src": "...", "layout": "g-third"},
{"src": "...", "layout": "g-third"},
{"src": "...", "layout": "g-third"}
],
"credits": [
["Diseño / Design", "周墨白"],
["Encuadernación manual / Binding", "陈漱石 (Hangzhou · Encuadernación artesanal)"]
]
}
Errores comunes de JSON ⚠️:
- Las comillas en la prosa china deben ser comillas chinas
「...」o"..."(U+201C / U+201D), no ASCII"(rompería el JSON). - No pongas saltos de línea reales en las cadenas JSON; para cambiar de párrafo, simplemente añade otro elemento en el array prose.
<em>palabra</em>en el lead se escribe directamente como etiqueta HTML — se renderizará como innerHTML.- El
layoutde la galería debe ser uno de tres:g-wide(ocupa todo el ancho) /g-half(ocupa la mitad) /g-third(ocupa un tercio).
6. Selección de fuentes de imagen
- Placeholder picsum: usa la forma
id/Xen lugar deseed/X(más estable). IDs que funcionan bien: 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200. - Para el cover y la galería de una misma obra, usa IDs adyacentes para crear una paleta de colores consistente.
- No uses el parámetro
?grayscale(el usuario quiere imágenes a color).
7. Inspiración para nombres de estudio chino (si el usuario no da uno)
Si el usuario te pide "inventa uno" → elige 2 caracteres con aire antiguo:
- Tipo objeto: 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
- Tipo letra: 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
- Evita palabras funcionales como "工作室 / 设计 / Studio"; que el nombre sea poesía en sí mismo.
8. Soporte de video
Si el cover de una obra es un archivo .mp4 / .webm / .mov, la página de detalle lo mostrará con <video autoplay muted loop> en lugar de <img>. El modelo solo necesita proporcionar la ruta del video en la URL del cover.
9. Informe
Modo A: Informe de una frase.
Se ha 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, vista lista/álbum en la parte superior central.
Modo B: Da directamente el bloque de código HTML completo + una línea de explicación.
Guarda el código de arriba como
index.htmly ábrelo con doble clic. 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 por las rutas de tus imágenes.
Elementos obligatorios (no modificar)
- Importación de la fuente:
@font-facepara cargar la URL woff2 de Alimama DaoLiTi (no cambiar la fuente). - Sistema de variables CSS: temas claro y oscuro.
- Todo el JS: alternancia de tema, alternancia de modo de vista, interacción de hover en filas, crédito rotativo, enrutamiento por hash de página de detalle (
applyRoute(),renderDetail()). - El nodo
<script id="works-data">debe permanecer. - El elemento
<main id="detail-root">debe permanecer (punto de montaje de la página de detalle). - El sistema de estados
body[data-view="home/detail"]ybody[data-mode="list/gallery"]. - Los cinco elementos de posición fija: #logo / #main-menu / .theme-toggle / #project-view / #svp-credit.
Lista de verificación de errores comunes
- Slug no coincide: El elemento de lista
#work/kong-shan-ji↔ El 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 el contenido chino deben ser comillas chinas «» o
"...", no ASCII". - Demasiadas imágenes en la galería: Máximo 6 imágenes por obra; más de eso desordenará el diseño.
- Prosa demasiado larga: Cada párrafo 80-150 caracteres; más de 200 caracteres empeora la experiencia de lectura.
- Lista / galería no sincronizadas: Deben contener el mismo conjunto de obras (correspondencia uno a uno).
- Seed de picsum: Usa
id/X, noseed/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: Se recomienda dividirlas en dos lotes; demasiadas filas alargan la página.
- Primera letra grande: El
.detail__prose p:first-of-type::first-letterusa la fuente DaoLiTi — el primer párrafo debe comenzar con un carácter chino (no con<em>o una letra inglesa). - Eliminación del color de picsum: Las imágenes deben ser a color; no añadas
filter: grayscale()en el CSS.