Communitygithub.com

FlineDev/SiteKit

Crea, personaliza y despliega sitios web con SiteKit, un generador de sitios estáticos estáticos en Swift con enfoque en IA. Úsalo al crear un nuevo sitio web, iniciar un proyecto SiteKit, escribir contenido, desplegar, personalizar el tema o extender un sitio existente con páginas o renderizadores personalizados.

¿Qué es SiteKit?

SiteKit es un generador de sitios estáticos Swift, con IA integrada, que organiza la generación en un **pipeline basado en fases**: Descubrimiento → Carga → Enriquecimiento → Renderizado de páginas → Renderizado del sistema → Procesamiento de salida, más teletransporte de activos independientes del contenido. Cada fase implementa un protocolo Swift; los sitios se componen con métodos factoría de `SiteBuilder` (`.blog()`, `.podcast()`, `.newsletter()`, `.portfolio()`, `.docs()`, `.docc()`) y se personalizan de forma fluida intercambiando o añadiendo plugins. La habilidad es particularmente útil para desarrolladores que buscan una solución moderna, rápida y amigable con la IA para construir sitios web estáticos con Swift. Soporta múltiples planos (blueprints) predefinidos, personalización completa de temas, despliegue a través de varios proveedores CI/CD y alojamiento, y extensiones de Markdown para DocC. La habilidad guía al usuario a través de referencias especializadas según su tarea, asegurando que siempre se consulte la documentación más relevante para instalación, configuración, escritura de contenido, personalización y despliegue.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FlineDev/SiteKit/tree/HEAD/Plugin/skills/sitekit

Preguntar en tu IA favorita

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

Documentación

¿Qué hace SiteKit?

SiteKit es un generador de sitios estáticos en Swift con enfoque en IA, construido alrededor de un pipeline orientado a fases: Descubrimiento → Carga → Enriquecimiento → Renderizado de páginas → Renderizado del sistema → Procesamiento de salida, más teletransporte de activos independientes del contenido. Cada fase es un protocolo Swift; los sitios se componen con métodos factoría de SiteBuilder (.blog(), .podcast(), .newsletter(), .portfolio(), .docs(), .docc()) y se personalizan de forma fluida intercambiando o añadiendo plugins.

Proceso

Dirige la intención del usuario a la referencia correcta. Lee solo las referencias que necesitas para la tarea actual.

Si el usuario pregunta sobre...Entonces lee...
Instalar SiteKit + iniciar el primer sitio (la CLI sitekit)references/bootstrap.md
Configurar un nuevo sitio desde ceroreferences/onboarding.md
Elegir un plano (Blog, Newsletter, Podcast, Portfolio, AppLanding, Snippets, IndieDev, DocC, Plain)references/blueprints.md
Escribir contenido (publicaciones de blog, números de newsletter, páginas estáticas)references/content-writing.md
Páginas legales / aviso legal / privacidad (según país, GDPR, cookies)references/legal-pages.md
Extensiones de Markdown DocC (@Metadata, @Row, @TabNavigator, @Video, @Image, @Links, …) + el contrato de degradación elegantereferences/markdown-extensions.md
Sitios multilingüe (traducciones, sufijos de locale, validación)references/localization.md
Auditoría de accesibilidad (contraste WCAG AA, texto alternativo, navegación por teclado)references/accessibility.md
SEO + ASO + descubrimiento por IA (URLs canónicas, OG, JSON-LD, llms.txt)references/seo-aso.md
Rendimiento / resultados de PageSpeed (LCP, CLS, renderizado bloqueante)references/performance.md
Desplegar el sitio (matriz de proveedores de host + CI) – empieza aquíreferences/deployment/SKILL.md
Personalización del tema (preajustes, esquemas de color, pares de fuentes, tokens)references/themes.md
Añadir una Page personalizada para un nuevo tipo de página HTMLreferences/custom-pages.md
Extender el pipeline (Loader, Enricher, Renderer, OutputProcessor, Teleporter)references/architecture.md
Solución de problemas de compilación / ejecuciónreferences/troubleshooting.md
Configuración de newsletter auto-alojada (Keila + SMTP)references/newsletter-setup.md
Elegir servicios externos (envío de correo, integraciones)references/external-services.md
Referencia de campos de SiteConfig.yamlreferences/siteconfig-reference.md

Despliegue – salta directamente a un proveedor

references/deployment/SKILL.md es el orquestador: detecta la variante de Package.swift, pregunta el modo de configuración y guía la autenticación CLI antes de enrutar a un archivo de CI + uno de host. Empieza ahí para un despliegue nuevo. Si ya conoces el destino (por ejemplo, reconfigurar un despliegue existente), salta directamente:

Si el usuario pregunta sobre...Entonces lee...
CI en GitHub Actionsreferences/deployment/ci/github-actions.md
CI en GitLab CIreferences/deployment/ci/gitlab-ci.md (comunitario; marcador de posición)
CI en Xcode Cloudreferences/deployment/ci/xcode-cloud.md (comunitario; marcador de posición)
CI en Bitrisereferences/deployment/ci/bitrise.md (comunitario; marcador de posición)
Alojamiento en Cloudflare Pagesreferences/deployment/hosts/cloudflare-pages.md
Alojamiento en GitHub Pagesreferences/deployment/hosts/github-pages.md
Alojamiento en Netlifyreferences/deployment/hosts/netlify.md
Alojamiento en Vercelreferences/deployment/hosts/vercel.md
Qué proveedores de CI están soportados / añadir un nuevo proveedor de CIreferences/deployment/ci/README.md
Qué hosts están soportados / añadir un nuevo proveedor de alojamientoreferences/deployment/hosts/README.md

Saltar directamente omite el modo de configuración del orquestador y la detección de Package.swift – hazlo solo cuando esos aspectos ya estén resueltos.

Vocabulario central (siempre disponible)

  • Plano (Blueprint) – una receta para un tipo de sitio. SiteBuilder expone métodos factoría (.blog(), .podcast(), .newsletter(), .portfolio(), .docs(), .docc()) que pre-componen la lista de plugins predeterminada para cada tipo de sitio. Los planos en disco bajo Plugin/blueprints/ son sitios de inicio que el plugin puede clonar.
  • Page – el protocolo orientado al usuario para el renderizado de páginas HTML. Es un sub-protocolo de Renderer. Los conformadores implementan pages(in:) y renderHTML(_:context:); PageShell.wrap(content:page:context:) aplica automáticamente el cromo estándar <head> / <header> / <footer>.
  • Renderer – protocolo de salida a nivel de sistema. Declara scope: .perLocale (predeterminado – se ejecuta una vez por locale) o .global (se ejecuta exactamente una vez por compilación, usado para sitemap, robots, llms.txt, _headers de Cloudflare). El pipeline distribuye según scope.
  • SiteBuilder – builder inmutable y fluido. Cada método de configuración (.renderer, .enricher, .processor, .teleporter, …) devuelve un nuevo SiteBuilder. .run() lee los verbos de CLI (build, serve, validate) y ejecuta el pipeline.
  • BuildContext – estado de solo lectura pasado a cada plugin de las Fases 3–6. Contiene config, themeConfig, sections, staticPages, tags, homeContent, router, uiStrings, outputDirectory, projectDirectory.
  • Comandos de compilación – swift run Site build escribe el sitio en _Site/. swift run Site serve ejecuta el servidor de desarrollo (por defecto :8080). swift run Site validate verifica la integridad de las traducciones en sitios multilingüe (los sitios de un solo idioma pasan trivialmente). --base-url <url> en build/serve anula SiteConfig.baseURL para esa ejecución (despliegues de staging).

Nota de estilo

Al generar contenido del sitio mediante esta habilidad, mantén una voz auténtica e independiente. Párrafos cortos. Pronombres personales. Sin rodeos corporativos. La guía completa de la voz del autor y las instrucciones del bucle de aprendizaje se encuentran en references/content-writing.md.

Pipeline de un vistazo

FaseProtocoloDónde extender
0. Teletransporte de activos (independiente del contenido)Teleporter.teleporter(_:)
1. DescubrimientoContentDiscovery.contentDiscovery(_:)
2. CargaLoader<Source, Output>.articleLoader(_:), .staticPageLoader(_:)
3. EnriquecimientoEnricher.enricher(_:)
4. Páginas HTML por localePage (sub-protocolo de Renderer).renderer(_:)
5. Renderizado del sistemaRenderer + RenderScope.renderer(_:)
6. Procesamiento de salidaOutputProcessor.processor(_:)

Para la justificación completa de la arquitectura y ejemplos prácticos de cada punto de extensión, lee references/architecture.md y references/custom-pages.md.

Véase también

Si una tarea no está cubierta por ninguna referencia anterior – estás modificando la propia biblioteca Swift de SiteKit en lugar de construir un sitio con ella – escala a la referencia de contribuidor en la raíz del repositorio: AGENTS.md (detalles internos del pipeline, protocolos de fase, puntos de intercambio de SiteBuilder, comandos de compilación y prueba).

Para un índice tarea → doc que abarque tanto la documentación orientada al usuario como estas referencias, consulta ../../../USE-CASES.md en la raíz del repositorio.

Skills relacionados