Communitygithub.com

WyvernCW/Monich

Genera un sitio web de portafolio de estudio chino en un solo archivo (lista horizontal + hover para revelar miniatura, tipografía artística lishu 'Alimama DaoLiTi' vía CDN, tema claro/oscuro, páginas de detalle con enrutamiento por hash). Toma una descripción en lenguaje natural del estudio (nombre, director, disciplina, obras) y genera UN archivo .html funcional. Funciona tanto en Claude Code (escribe en ~/Desktop) como en GLM / chat online (genera HTML inline). Frases de activación: '做个中式工作室作品集', '做个隶书作品集', 'lishu-portfolio-gen ...', '做个白屋风格的作品集', o cuando el usuario arrastra la carpeta del skill al chat pidiendo un sitio estilo atelier.

¿Qué es Monich?

Este skill genera un sitio web de portafolio para un estudio chino en un solo archivo HTML, con un diseño minimalista y elegante que destaca la tipografía lishu (Alimama DaoLiTi). La interacción principal consiste en una lista horizontal de nombres de proyectos; al pasar el mouse sobre cada nombre, aparece una miniatura a la derecha. Incluye un sistema de enrutamiento por hash para páginas de detalle de cada obra, con soporte para temas claro y oscuro, y dos modos de visualización: lista y galería. Es ideal para estudios de encuadernación, caligrafía, artesanía, diseño gráfico, o cualquier proyecto que requiera una estética china clásica y contenida. Funciona en dos modos: modo A (Claude Code, con sistema de archivos) escribe el archivo en ~/Desktop y puede usar imágenes locales; modo B (GLM o chat online, sin sistema de archivos) genera el HTML completo en un bloque de código, usando imágenes de placeholder (picsum) si es necesario. El skill lee dos archivos de referencia: template.html (estructura base con marcadores SWAP) y reference.html (ejemplo completo para aprender el tono y la densidad de datos), y produce un único archivo HTML listo para usar.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/WyvernCW/Monich/tree/HEAD/templates/web-template/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 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

skillModo principalPara quién es
portfolio-genLienzo de arrastre infinito + mosaicoFotógrafos / diseñadores gráficos para mostrar muestras
portfolio-museum-genCarrusel hero + tarjetas grandes + cascada + página de detalle (sensación curatorial de video)Artistas de video / instalación / instalación
industrial-archive-genPortada de página negra con marco + archivo lateral + nórdico industrialProductos físicos / objetos / hardware
lishu-portfolio-genFilas de texto horizontal + miniatura a la derecha al pasar el mouse + letras grandes en lishu + contención chinaEncuadernació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 Bash para listar carpetas, sips para 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

ArchivoRolCómo usarlo
reference.htmlEjemplo completo de referencia — BAIWU con 6 obrasMira: la redacción de los elementos de lista, el tono de la prosa, el vocabulario de las especificaciones, la densidad de campos JSON
template.htmlEsqueleto vacío — mismo sistema CSS/JS/enrutamiento, 2 ejemplos + 20 marcas SWAPModifícalo para generar el HTML final
README.mdInstrucciones de uso para el usuarioEl modelo no necesita leerlo
SKILL.mdFlujo 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.html para entender "cómo se ve cuando está completo" (especialmente la densidad de campos JSON y el tono de la prosa).
  • Luego lee template.html para 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

SWAPUbicaciónContenido
1<title>{ATELIER_NAME} {PINYIN} — {DIRECTOR} Portafolio / Studio
2meta descriptionUna breve descripción del sitio
3Carácter único del telónPrimer carácter del nombre del estudio (ej. «白»)
4Carácter único dentro del SVG del logoIgual que SWAP-3
5Pinyin dentro del SVG del logo{PINYIN} en MAYÚSCULAS
6Lista de navegación principalGeneralmente 3 elementos: Obras / Acerca de / Contacto
7Nombre chino del bloque de marca{ATELIER_NAME} con espacios entre caracteres (ej. 白&nbsp;&nbsp;屋)
8Inglés del bloque de marca{PINYIN} Studio · {CITY}
9TaglineUna frase de posicionamiento en kaishu, 20-40 caracteres, puede usar <br> para saltos de línea
10N elementos de listaCada <a class="item" href="#work/{slug}"> que incluye num/project-name/en-name/location/photo-thumb
11N elementos de galeríaLas mismas N obras, en una cuadrícula más compacta — el slug debe coincidir con el de la lista
12Título de Acerca deAc&nbsp;er&nbsp;ca&nbsp;de&nbsp;{name}<span class="en">About</span>
13Párrafos de Acerca de1-3 párrafos en kaishu (contexto de fundación / director / filosofía de diseño), cada uno de 60-120 caracteres
14Tabla de hechos de Acerca de4-6 elementos li (Año de fundación/Ubicación/Disciplina/Director/Horario)
15Título de ContactoCon&nbsp;tac&nbsp;to<span class="en">Get in Touch</span>
16Párrafos de Contacto1-2 párrafos invitando a escribir + promesa de tiempo de respuesta
17Tabla de hechos de Contacto4-6 elementos (E-mail/Phone/Address/Instagram/公众号)
18Crédito rotativoSitio por {WHO} (generalmente el nombre del estudio)
19Pie de página: tres bloques© / ICP / enlaces a redes sociales
20JSON de datos de obrasDatos 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 layout de 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/X en lugar de seed/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.html y á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-face para 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"] y body[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, 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: Se recomienda dividirlas en dos lotes; demasiadas filas alargan la página.
  • Primera letra grande: El .detail__prose p:first-of-type::first-letter usa 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.

Individual skills in this repo

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

Skills relacionados