Pods Architecture Skill

Arquitectura de Pods

La arquitectura de pods es un enfoque escalable para organizar proyectos frontend agrupando código relacionado (componentes, estilos, lógica y tests) en unidades autocontenidas llamadas pods. Cada pod representa una funcionalidad o área de dominio, lo que hace que las bases de código sean más fáciles de navegar, mantener y escalar a medida que los proyectos crecen.

Para aprender más sobre el patrón de arquitectura de pods y cómo se aplica a proyectos frontend, consulta el post completo:

🔗 Arquitectura de Pods: Islas de código para proyectos frontend escalables

Instalación

Los skills de Content Island están publicados en npm y se instalan en la carpeta .claude/skills/ de tu proyecto, donde Claude Code los detecta automáticamente — no hace falta instalación global.

La forma más sencilla es el selector interactivo, que lista todos los skills preseleccionados; deselecciona los que no quieras y pulsa enter:

npx @content-island/ai-skills

Para instalar un skill de Arquitectura de Pods directamente, elige el que corresponda a tu stack:

# Astro
npx @content-island/ai-skills install astro-pods

# TanStack Start
npx @content-island/ai-skills install content-island-tanstack-start-pods-architecture

Otras opciones en modo comando:

# Listar los skills disponibles
npx @content-island/ai-skills list

# Instalar todos los skills
npx @content-island/ai-skills install all

# Sobrescribir un skill ya instalado
npx @content-island/ai-skills install astro-pods --force

Cada skill se instala en .claude/skills/content-island-<skill-name>/SKILL.md. Requiere Node.js 18 o superior.

Skill de Content Island para Pods (AI Tools)

Definición del skill (fuente de la verdad)

🔗 https://github.com/content-island/content-island-ai-skill/blob/main/skills/content-island-astro-pods-architecture/SKILL.md

Este archivo es la fuente autoritativa del skill de IA de Content Island para Pods. Define exactamente cómo las herramientas de IA deben estructurar, organizar y trabajar con proyectos basados en pods.

Content Island proporciona una definición de skill para IA que permite a las herramientas de desarrollo asistidas por IA trabajar con el patrón de Arquitectura de Pods en proyectos Astro.

Este skill está diseñado para evitar alucinaciones y garantizar que todo el código y las estructuras de proyecto generadas estén estrictamente basadas en la documentación oficial de la arquitectura de pods.

Qué hace este skill

El skill de Arquitectura de Pods indica a las herramientas de IA que deben:

Crear estructuras de proyecto siguiendo el patrón de pods
Agrupar componentes, estilos, lógica y tests relacionados en pods autocontenidos
Seguir las convenciones de nombres y estructura de carpetas definidas en la documentación oficial
Evitar inventar o adivinar patrones de organización que no estén documentados

La precisión siempre tiene prioridad sobre la completitud.

Herramientas de IA compatibles

El skill puede ser utilizado por herramientas de IA que soportan archivos de instrucciones externas o a nivel de repositorio, incluyendo:

GitHub Copilot (Chat, Inline, Copilot Workspace)
Claude Code
Otras herramientas de IA para desarrollo que soporten instrucciones personalizadas

Al estar definido de forma declarativa en Markdown, el comportamiento es consistente entre herramientas y compartido por todo el equipo.

Por qué existe

Las herramientas de IA son muy potentes, pero cuando se estructuran proyectos, una suposición incorrecta sobre la organización puede llevar a código inmantenible.

Este skill existe para garantizar que:

Las estructuras de proyecto generadas sigan el patrón de arquitectura de pods
La organización del código coincida siempre con la documentación oficial
Los desarrolladores puedan confiar en las respuestas de la IA al configurar o extender proyectos basados en pods

En resumen:

Sin documentación → sin respuesta.