CommunityProgramación y desarrollogithub.com

cbrock84/interface-craft

Eleva la calidad visual y de interacción de una interfaz: diseño, jerarquía, tipografía, espaciado, densidad y los detalles que distinguen un producto cuidado de uno genérico. Úsalo cuando una pantalla funciona pero se ve inacabada o por defecto, cuando un diseño se siente abarrotado o arbitrario, cuando una página no tiene un punto focal claro, o cuando una interfaz necesita sentirse confiable en lugar de meramente funcional.

¿Qué es interface-craft?

Este skill, llamado 'Interface Craft', está diseñado para mejorar la calidad visual y de interacción de las interfaces de usuario, abordando problemas que van más allá de la funcionalidad básica. Se enfoca en refinar la jerarquía visual, el ritmo de espaciado, la tipografía, la moderación en superficies y la alineación, elementos que transforman una interfaz genérica en una que se siente considerada y profesional. Es especialmente útil cuando una pantalla funciona pero se ve inacabada, cuando el diseño está desordenado o no tiene un punto focal claro, y cuando se busca que la interfaz inspire confianza. Compatible con cualquier plataforma de desarrollo de interfaces (web, mobile, etc.), el skill proporciona principios y pautas concretas para diagnosticar antes de rediseñar, decidir la densidad adecuada, manejar todos los estados (carga, vacío, error, desbordamiento), implementar modo oscuro correctamente y cumplir con un piso de accesibilidad que garantice que la interfaz sea usable para todas las personas. Su enfoque es práctico y evita añadir peso visual innecesario, priorizando la eliminación de elementos redundantes.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cbrock84/headcount/tree/main/plugins/product/skills/interface-craft

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Diseño de interfaz

La mayoría de las interfaces no fallan por las ideas. Fallan en la ejecución: espaciado que es casi consistente, jerarquía que es casi clara, tipografía que es casi correcta.

Diagnosticar antes de rediseñar

Pregunta para qué sirve la pantalla. Una acción principal, como máximo una secundaria. Si no puedes nombrar la acción principal, el problema de diseño es un problema de producto y ningún estilo lo soluciona.

Las cosas que realmente se perciben como calidad

Jerarquía. Un espectador debe saber dónde mirar antes de leer nada. Consíguelo con tamaño, peso y espacio, en ese orden. El color es la herramienta de jerarquía más débil y la más sobreutilizada.

Ritmo de espaciado. Las cosas relacionadas están más cerca que las no relacionadas, y los espacios provienen de una sola escala. El espaciado inconsistente es el defecto que la gente siente pero no puede nombrar. Consigue la proximidad correcta y un diseño sencillo se lee como diseñado.

Tipografía. Una familia para la interfaz, dos como máximo en la página. Establece una escala real y usa sus pasos en lugar de inventar tamaños. El texto del cuerpo quiere una medida cómoda: aproximadamente 60–75 caracteres— y una altura de línea que crece a medida que la medida se ensancha.

Moderación en las superficies. Los bordes, las sombras y los rellenos separan cosas. Elige uno por límite. Apilar los tres es por lo que las interfaces se ven recargadas con una densidad normal.

Alineación. Todo se alinea con algo. Un elemento alineado con nada se lee como un error incluso cuando es intencional.

La densidad es una decisión

Una herramienta con mucha información y una página de marketing quieren tratamientos opuestos. Decide cuál es esta y comprométete: el término medio incómodo, donde una tabla de datos tiene el padding de una página de aterrizaje, no sirve a ninguna.

Termina los estados

Carga, vacío, error y desbordamiento son donde los productos se sienten inacabados. Un estado vacío es una oportunidad de diseño; un spinner sin contexto es una admisión. Las cadenas largas, las listas largas y las pantallas pequeñas deben manejarse, no esperarse.

El modo oscuro es una paleta, no una inversión

Invertir un tema claro produce el característico modo oscuro malo: fondos negros puros, texto blanco puro y sombras que no hacen nada.

  • Usa un gris muy oscuro en lugar de negro puro, y un blanco ligeramente atenuado en lugar de blanco puro. El contraste máximo entre ambos causa halos y es genuinamente cansado de leer.
  • La elevación se invierte: en temas claros las superficies elevadas proyectan sombras, en temas oscuros se vuelven más claras. La sombra por sí sola no transmite nada sobre un fondo oscuro.
  • Los colores saturados que funcionaban sobre blanco vibrarán sobre oscuro. Desatura y aclara los colores de acento para la paleta oscura en lugar de reutilizarlos.
  • Define ambas paletas juntas, a nivel de token, desde el principio. Readaptar significa auditar cada superficie.

Piso de accesibilidad

Estos no son elementos de pulido: por debajo de ellos, algunas personas no pueden usar la interfaz en absoluto.

  • Contraste de texto que cumpla con la relación estándar contra su fondo real, incluido texto sobre imágenes y dentro de botones de color.
  • Nunca transmitas significado solo con el color. Un borde rojo que indica un error necesita texto o un icono también.
  • Cada elemento interactivo accesible por teclado, en un orden sensato, con un estado de foco visible.
  • Objetivos táctiles lo suficientemente grandes como para pulsarlos de manera confiable, con espacio entre los adyacentes.
  • Respeta la preferencia de movimiento reducido: la animación que no se puede deshabilitar causa síntomas reales en algunos usuarios.
  • Elementos semánticos reales: botones que son botones, encabezados en orden. Un div estilizado es invisible para la tecnología de asistencia.

Nunca

  • Añadas peso visual para solucionar un problema de jerarquía causado por demasiados elementos iguales. Elimina en su lugar.
  • Centres el texto del cuerpo.
  • Publiques un estado de hover sin el estado de foco correspondiente.

Individual skills in this repo

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

cbrock84/org-design

Designs how an organization is structured — reporting lines, team boundaries, spans and layers, role definition, and workforce planning against the strategy. Use this to structure a new team, restructure an existing one, resolve unclear ownership between teams, plan headcount, or diagnose why a team underperforms for structural rather than individual reasons.

cbrock84/portfolio-governance

Governs the portfolio of work — intake, prioritization, stage gates, resource contention, and stopping things. Use this to set up intake and prioritization, run a stage gate, decide between competing initiatives, resolve resource contention across projects, or work out why everything is in flight and nothing is finishing.

cbrock84/product-launch

Takes something built and gets it into the market — tiering the launch to match what it actually warrants, sequencing internal readiness before external announcement, preparing sales and support to answer the questions it creates, choosing the date for a reason, and measuring adoption rather than announcement reach. Use this to plan a launch, right-size one that is consuming more than it deserves, work out why a released feature nobody uses was launched loudly, or run the weeks after launch day.

cbrock84/program-management

Plans and drives cross-functional programs to delivery — scope, sequencing, dependencies, status, risk, and the escalations that keep work moving. Use this to run a multi-team initiative, recover a program that is slipping, build a delivery plan with dependencies, structure status reporting, or diagnose why cross-team work keeps missing dates.

cbrock84/project-delivery

Plans and delivers a single project — scope, estimation, scheduling, critical path, tracking, and recovering when it slips. Use this to plan a project, build or challenge a schedule, estimate credibly, track progress meaningfully, or recover a project that is late.

cbrock84/retention

Diagnoses and reduces churn — cancellation flows, save offers, failed-payment recovery, at-risk detection, and the product and service causes underneath. Use this when churn is rising or unexplained, to design a cancellation or win-back flow, to recover involuntary churn, to identify at-risk accounts before they leave, or to decide whether a retention problem is a product problem.

cbrock84/sales-enablement

Builds what a sales team needs to sell — pitch decks, one-pagers, objection handling, competitive battlecards, demo scripts, and case studies. Use this to create or fix sales collateral, prepare for a competitive deal, build a demo flow, document objection responses, or diagnose why a pitch is not converting.

cbrock84/tax

Structures the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations created by hiring or selling somewhere new. Use this to work out what a new state or country obligates you to, prepare for a tax filing or audit, understand sales tax on your product, or check what a remote hire or new market triggers.

cbrock84/unit-economics

Establishes whether the business makes money on each customer or unit — contribution margin, acquisition cost, payback period, lifetime value, and the cohort behavior underneath. Use this to assess whether growth is profitable, evaluate a channel or segment, support a pricing decision, judge how fast the business can afford to grow, or diagnose why revenue growth is not producing profit.

cbrock84/video-content

Plans and scripts short-form and long-form video, and designs the packaging — titles, thumbnails, and openings — that determines whether it gets watched. Use this to script a video, plan a series, fix retention or click-through problems, design thumbnail and title concepts, or turn written content into video. For a YouTube channel specifically — idea selection, retention teardowns, and channel-level strategy — use `youtube-producer`.

cbrock84/visual-content

Designs and directs the visual assets that carry content — carousels, infographics, quote graphics, diagrams, and social imagery — including the generation prompts where they are AI-produced. Use this to turn a written piece into a visual format, design a carousel or infographic, create social graphics, or fix visuals that are not stopping the scroll.

Skills relacionados