Communitygithub.com

SongGithub/personal-skills

Un sistema de diseño reutilizable para documentos HTML: CVs, resúmenes e informes breves. Incluye tokens de diseño, maquetación, tipografía, reglas de impresión a PDF y accesibilidad. Úsalo al generar o rediseñar un documento HTML autocontenido para lectura en pantalla o impresión en PDF.

¿Qué es personal-skills?

Este skill proporciona un sistema de diseño completo y autocontenido para documentos HTML, ideal para CVs, resúmenes de una página e informes breves. Su principal objetivo es garantizar que el documento se vea correctamente en pantalla y se imprima limpiamente a PDF, sin necesidad de paso de compilación alguno: un único archivo que se puede abrir en cualquier lugar. El sistema define tokens de diseño (colores, superficies) mediante propiedades personalizadas CSS en `:root`, con una variante para tema oscuro, y establece reglas estrictas para evitar valores hexadecimales fijos. La maquetación se centra en un ancho máximo de 820px, relleno de 38–42px y espaciado entre secciones de 15px, utilizando una tipografía de sistema sin fuentes web (tamaño base de 12.8px). Las reglas de impresión están cuidadosamente diseñadas: tamaño carta, márgenes cero, fondo blanco forzado y `break-inside: avoid` para evitar que una entrada laboral se divida entre páginas. Además, se incluyen pautas de accesibilidad como el uso de encabezados semánticos (`h1`, `h2`), contraste suficiente y listas con estructura semántica para lectores de pantalla. El skill es compatible con cualquier editor o agente de IA que genere HTML (como Claude Code, Cursor o Codex) y se usa copiando la plantilla `references/cv-template.html` como punto de partida. También enumera anti-patrones claros (columnas múltiples, tablas para maquetación, imágenes o fuentes de iconos, etc.) para asegurar un documento limpio, accesible y fácil de convertir a PDF.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SongGithub/personal-skills/tree/HEAD/document-design/skills/document-design

Preguntar en tu IA favorita

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

Documentación

Diseño de documentos

Un sistema de diseño para documentos HTML autocontenidos. El objetivo: correcto en pantalla, limpio al imprimir a PDF y sin paso de compilación: un solo archivo que puedes abrir en cualquier lugar.

Copia references/cv-template.html como punto de partida; ya integra todo lo que se describe a continuación.

Tokens de diseño

Coloca cada color y superficie en propiedades personalizadas en :root, con una variante para tema oscuro. Nunca codifiques un valor hexadecimal en una regla; eso es lo que hace que el documento sea tematizable e imprimible.

:root {
  --doc-background: #ffffff;
  --doc-background-mid: #eef0ee;   /* fondo de página */
  --doc-border-light: #e3e3e0;
  --doc-text-primary: #1d1f22;
  --doc-text-secondary: #5f6368;
  --doc-accent: #1f6f5c;           /* un solo acento, usado con moderación */
  --doc-accent-soft: #e7f1ee;      /* fondo de chip/matiz */
}
html[data-theme='dark'] {
  --doc-accent: #4fbfa3;
  --doc-accent-soft: #16332b;
}

Reglas:

  • Un solo color de acento. Marca encabezados de sección, el nombre del cargo/empresa, los marcadores de viñeta y nada más. El acento en todas partes se lee como decoración.
  • Dos colores de texto. Primario para el contenido, secundario para metadatos (fechas, ubicaciones, notas).
  • Matiz, no relleno. Usa --doc-accent-soft para chips en lugar de bloques sólidos de acento.

Maquetación

  • Ancho máximo de página 820px, centrado, con un margen superior de 24px. Más ancho que esto y la longitud de línea perjudica la legibilidad.
  • Relleno de página 38–42px. El relleno carga el peso visual, por lo que no se necesita un borde exterior.
  • El fondo de la página es --doc-background-mid para que la página blanca se lea como una hoja.
  • Las secciones se apilan con un espacio de 15px. La estructura proviene del espaciado y de una sola línea fina debajo de cada encabezado de sección, no de cajas o paneles.

Tipografía

  • Pila de fuentes del sistema, sin fuentes web: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif. Nada que cargar, nada que falle sin conexión.
  • Base pequeña: 12.8px en pantalla con interlineado de 1.38. Esto es un documento, no una entrada de blog: la densidad es una característica.
  • Escala: nombre 28px/700, encabezado de sección 11.5px/700 mayúsculas con espaciado de letras de 1.3px, título del cargo 13.5px/700, cuerpo 12–12.5px, metadatos 11px.
  • Los encabezados de sección están en mayúsculas y con color de acento, con una línea fina debajo. Ese es el único tratamiento de encabezado; no agregues otro nivel de jerarquía visual.
  • Separación silábica y justificación: deja el texto alineado a la izquierda, nunca justificado.

Reglas de impresión

La impresión a PDF es el uso principal, por lo que el bloque de impresión es tan importante como el de pantalla.

  • @page { size: letter; margin: 0 } con el relleno movido al contenedor de la página, lo que da control sobre los márgenes.
  • Fuerza fondos blancos y establece print-color-adjust: exact para que los chips con matiz se mantengan.
  • Reduce a ~10pt con interlineado de 1.3. Los tamaños de pantalla son demasiado grandes en papel.
  • break-inside: avoid en cada cargo, subcargo y el encabezado, para que ninguna entrada laboral se divida entre páginas.
  • Oculta el marco interactivo — botones, enlaces con estilo de controles — en la impresión.

Accesibilidad

  • Mantén el contraste: texto primario sobre blanco, acento solo para encabezados y marcadores. Nunca uses el acento para texto largo del cuerpo.
  • Usa elementos de encabezado reales (h1, h2) en un orden lógico; aplica mayúsculas mediante CSS en lugar de escribirlas en el texto.
  • Proporciona a los enlaces un texto descriptivo; no te bases solo en el color para distinguirlos.
  • Mantén la estructura de lista semántica para las viñetas: los lectores de pantalla anuncian la longitud de la lista, lo que ayuda en un CV largo.

Anti-patrones

  • Diseños de varias columnas: se rompen en la impresión y los lectores de pantalla los leen en el orden incorrecto.
  • Tablas para maquetación.
  • Imágenes o fuentes de iconos en lugar de texto; no sobreviven a la extracción de texto de PDF ni al análisis ATS.
  • Encabezados con relleno sólido de acento, degradados, sombras paralelas en el contenido o reglas decorativas entre cada sección.
  • Encabezados y pies de página inyectados por el navegador (fecha, URL, recuento de páginas): desactívalos en el diálogo de impresión.

Individual skills in this repo

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

SongGithub/personal-skills

Applies a direct, plain-spoken, Australian-English communication style to any text drafted — chat replies, emails, Slack/Teams messages, tickets, PR and commit descriptions, docs. Use whenever drafting prose, not just visual or code artifacts. Skip when the user explicitly asks for a different tone or voice.

SongGithub/personal-skills

End-to-end job application workflow. Screen a posting, tailor the HTML CV from the master template, print it to PDF, archive the artifact, and file the result against the configured tracker. Triggers on apply, apply to jobs, submit application, tailor and send CV.

SongGithub/personal-skills

CV attach workflow. Generate a tailored HTML CV for a tracked role, attach the rendered artifact back to its tracker item, then verify the attachment actually landed. Covers template selection, tailoring order, upload headers, and read-back verification.

SongGithub/personal-skills

First-principles reasoning for a startup or a job search, in the spirit of Elon Musk's "zero restart" framing: survival cashflow, the idiot index, and the physical first step. 第一性原理创业与求职法 — 从马斯克「归零重启」思维出发,用生存现金流、白痴指数、长期物理第一步三个步骤,指导创业和求职

SongGithub/personal-skills

How to file a job opportunity as a Jira issue — summary format, required fields, duplicate check, description formatting and attachments. Applies when tracker_backend is jira. Use when a job posting becomes a tracker record, and when creating or updating job records on a Jira board.

SongGithub/personal-skills

Assistant for job applications: evaluating job postings, tailoring CVs, writing cover letters, and preparing for interviews. Triggers on keywords like: job posting, job application, CV, cover letter, resume, interview prep, job fit, career, application, apply, SEEK

SongGithub/personal-skills

Job scraper. Searches job boards for new positions matching the candidate profile, deduplicates against previously seen jobs and the tracker file, then presents new matches with a quick fit assessment. Triggers on: job scrape, find jobs, search jobs, new jobs, /scrape.

SongGithub/personal-skills

Screen job opportunities, prepare job records and tailored CVs, and verify the result against current salary, title, source, and document-quality preferences. Applies to job boards and scheduled searches.

SongGithub/personal-skills

Trello card rules for the job-search tracker. Enforces case-insensitive and fuzzy duplicate detection before any card is created, title formatting, lane placement from config, and logging each card to the tracker database. Applies whenever a job posting becomes a card.

SongGithub/personal-skills

Compares tracked job postings against the candidate profile to find skill gaps, then builds a prioritised gap heatmap and a learning plan with searched study resources and a study order. Triggers on: upskill, skill gaps, what should I learn, learning plan, upskill report.

Skills relacionados