Communitygithub.com

pikaOne1138/astro-personal-site-starter

Diseña, construye, refina o audita sitios Astro pulidos para los arquetipos de taller de conocimiento/blog y asistente/servicio profesional.

¿Qué es astro-personal-site-starter?

El skill 'Astro UI Craft' guía la creación de sitios web con Astro que se sienten diseñados, no simplemente generados. Define dos arquitecturas de contenido principales (Conocimiento/Blog y Asistente/Servicio Profesional) y tres personalidades visuales (Papel y Tinta, Luz Matutina y Estudio Silencioso), que se tratan como combinaciones independientes pero coherentes, no como seis bases de código separadas. Su utilidad radica en proporcionar un marco estructurado para decidir flujos de página, navegación, llamadas a la acción y elementos visuales, asegurando consistencia y buena experiencia de usuario. Es compatible con cualquier proyecto Astro y se basa en una jerarquía de evidencia que prioriza observaciones directas y patrones verificados, con un guardarraíl de alcance que limita el trabajo a la parte frontal pulida, evitando la expansión silenciosa hacia sistemas complejos como CRM o pagos. El skill incluye reglas detalladas sobre UI, animaciones, responsividad y una puerta de calidad para garantizar un producto final refinado.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pikaOne1138/astro-personal-site-starter/tree/HEAD/.ai/astro-ui-craft

Preguntar en tu IA favorita

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

Documentación

Astro UI Craft

Construye sitios web que se sientan diseñados, no meramente generados.

Modelo central

Dos arquitecturas de contenido:

  • Conocimiento / Blog
  • Asistente / Servicio Profesional

Tres personalidades visuales:

  • Papel y Tinta
  • Luz Matutina
  • Estudio Silencioso

Trátalo como 2 arquitecturas × 3 direcciones visuales, no seis bases de código no relacionadas.

Guardarraíl de alcance

El alcance predeterminado es un sitio front-end pulido. Prefiere formularios externos, LINE, servicios de reserva y boletines. No te expandas silenciosamente a CRM, autenticación, sistemas de miembros, motores de reserva personalizados, pagos, bases de datos o administración SaaS.

Jerarquía de evidencia

  1. Observaciones directamente abiertas / captura de pantalla / CSS calculado.
  2. Observaciones buscadas en la web y verificadas en la página.
  3. Patrones entre casos derivados de casos verificados.
  4. Propuestas de diseño y tokens sintetizados.
  5. Listas candidatas solo en memoria o no verificadas explícitamente.

Trabajo de la página de Conocimiento / Blog

Responde:

  • ¿Sobre qué escribe esta persona?
  • ¿Por dónde debería empezar un nuevo lector?
  • ¿Cómo encuentro más sobre un tema?
  • ¿Por qué debería seguirle?
  • ¿Cuál es la siguiente acción de baja fricción?

Flujo predeterminado: Hero → Empieza aquí/temas → destacado/último → Acerca de breve → recurso → boletín → Pie de página

Trabajo de la página de Asistente / Servicio Profesional

Responde:

  • ¿Estoy en el lugar correcto?
  • ¿Esta persona entiende mi situación?
  • ¿Qué ofrece?
  • ¿Qué pasa si le contacto?
  • ¿Por qué puedo confiar en él/ella?
  • ¿Cuál es la siguiente acción de baja presión?

Flujo predeterminado: Hero → empatía → servicios → primera visita/proceso → Acerca de/Credenciales → confianza → FAQ → reserva/contacto → Pie de página

Prefiere aproximadamente 7 ± 1 secciones significativas.

Personalidades visuales

Papel y Tinta

Papel cálido, tinta oscura, tipo display serif, reglas finas, imágenes de baja saturación, listas editoriales.

Luz Matutina

Crema, acentos de arcilla/rosa/salvia, serif suave + sans legible, radios generosos, imágenes de luz natural, tranquilidad suave.

Estudio Silencioso

Gris cálido casi blanco, cuadrícula precisa, tipo con énfasis en sans, un acento fuerte, bordes finos, metadatos de contenido/servicio estructurados.

Reglas de UI refinadas

  • Estructura antes que decoración.
  • Escala de espaciado consistente.
  • Medida de formato largo aproximadamente 60–72 caracteres.
  • Un acento principal + neutros.
  • Relaciones de aspecto de imagen y tratamiento tonal consistentes.
  • Retroalimentación visible hover/foco/activo.
  • Evita morado neón, excesivo glassmorphism, cuadrículas bento aleatorias, secciones repetidas de tres columnas con iconos, gradientes vagos gigantescos, contadores/carruseles/efectos de máquina de escribir gratuitos.

Navegación

Escritorio: [Logo] 4–5 enlaces ... [único CTA principal]

  • Conocimiento: Artículos / Temas / Empieza aquí / Acerca de + Suscribirse.
  • Asistente: Servicios / Proceso / Acerca de / Artículos / FAQ + Reservar/Contactar.
  • Evita mega menús para la base del taller.

CTA

Como máximo tres niveles semánticos:

  • Principal: Suscribirse O Reservar una intro.
  • Secundario: entender ajuste/proceso/recurso gratuito.
  • Baja presión: leer/explorar/aprender más.

Lenguaje para asistentes: “預約初談”, “了解合作方式”, “第一次來?先看看流程”, “開始聊聊”.

Movimiento

  • hover 150–220ms
  • transiciones de UI 180–350ms
  • revelar 400–650ms
  • movimiento 4–16px
  • escala ~0.98–1.03
  • ease-out consistente
  • prefiere transformar + opacidad
  • respeta prefers-reduced-motion

El efecto deseado: los usuarios pueden no notar conscientemente la animación, pero el sitio se siente cuidado.

Responsivo

No te limites a encoger el escritorio.

  • Escritorio: contenedor de ~1080–1200px.
  • Tablet: simplifica diseños divididos/contenido lateral fijo.
  • Móvil: flujo de lectura único, amplio relleno lateral, controles de ancho completo donde sea útil.
  • El asistente puede usar un CTA de reserva persistente solo si no cubre contenido.

Puerta de calidad

Antes de la entrega:

  • el trabajo principal de la página es obvio;
  • la jerarquía se lee correctamente sin decoración;
  • la composición móvil funciona;
  • el contraste/los objetivos táctiles/los estados de foco son utilizables;
  • el movimiento es sutil y opcional;
  • la compilación tiene éxito;
  • no hay desviación accidental del alcance del backend.

Skills relacionados