CommunityImagengithub.com

store-pack

Genera un paquete de envío para Google Play y App Store (iconos, capturas enmarcadas en tamaños exactos, gráfico destacado, texto de ficha, respuestas de formularios de consola, análisis de bloqueos) en una carpeta `store/` del proyecto. Úsalo cuando te pidan dejar una aplicación lista para Play Store / App Store o preparar recursos, fichas o respuestas de formularios de consola.

¿Qué es store-pack?

**store-pack** es una habilidad para agentes de IA (como Claude Code, Cursor, Codex) que automatiza la generación de todos los activos y textos necesarios para publicar una aplicación en Google Play y App Store. Produce una carpeta `store/` con iconos, capturas de pantalla enmarcadas en las dimensiones exactas de cada tienda, un gráfico destacado, el texto de la ficha (respetando los límites de caracteres), las respuestas para los formularios de la consola y un análisis de bloqueos potenciales. Requiere Python 3, Flutter SDK (para el compositor de imágenes como test) y macOS (para `sips`). El flujo de trabajo incluye la inspección del proyecto para obtener datos reales (ID del paquete, versión, permisos, SDKs, cómo funcionan cuentas y pagos), la captura de pantallas con datos inventados realistas, la ejecución de scripts de Python para componer y empaquetar todo, y la generación de documentación para los bloqueos. Está diseñado para que el desarrollador solo tenga que revisar y subir los archivos, sin que el agente realice envíos, commits ni despliegues. Incluye una lista detallada de bloqueos comunes aprendidos (pagos, eliminación de cuenta, inicio de sesión con Apple, IDs de anuncios, permisos, acceso para revisores, política de privacidad, firma de lanzamiento, etc.) y las especificaciones exactas de cada tienda para imágenes y textos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nowfalsalahudeen/store-pack/tree/HEAD

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

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

Documentación

¿Qué hace store-pack?

Genera la carpeta store/ en la raíz del proyecto: iconos, capturas de pantalla enmarcadas, un gráfico destacado, texto de ficha, respuestas de formularios de consola y un README con bloqueos. Nunca envíes, hagas commit ni despliegues; deja eso al usuario.

Requisitos: Python 3, Flutter SDK (el compositor de imágenes es un test de Flutter, no necesita una app), y macOS (sips para comprobaciones de imágenes y tamaños de iconos). Las capturas de pantalla sin procesar provienen de la propia aplicación.

Flujo de trabajo

  1. Inspecciona la aplicación para obtener datos reales (nunca inventes): ID del paquete/bundle, versión, permisos (AndroidManifest, Info.plist), SDKs en pubspec, Cargo.toml o package.json (anuncios, analíticas, informes de fallos, facturación, inicio de sesión), cómo funcionan las cuentas y los pagos, URL de política de privacidad y soporte, configuración de firma, familias de dispositivos. Lee la documentación de contribución del proyecto para conocer sus reglas.
  2. Capturas de pantalla sin procesar. Captúralas desde la aplicación real con datos inventados realistas. Nunca uses datos de producción ni una cuenta de producción.
    • Flutter: un test harness de widgets con fuentes reales (debugDisableShadows = false, o las sombras se renderizan como contornos duros); teléfono 440x956 a 3x = 1320x2868.
    • Aplicaciones web, de escritorio o híbridas: ejecuta el servidor propio de la aplicación en una base de datos temporal, siémbrala a través de la API y maneja la interfaz con una herramienta de automatización del navegador. Usa un contexto de navegador separado con deviceScaleFactor 3 (teléfono, viewport 440x956) o 2 (tableta, 1032x1376) y oculta las barras de desplazamiento con *::-webkit-scrollbar{display:none!important}*{scrollbar-width:none!important} antes de cada captura.
    • Mata solo el proceso que escucha en tu propio puerto temporal (lsof -ti tcp:PORT -sTCP:LISTEN), nunca por nombre.
    • Revisa cada captura a simple vista. Descarta las que estén rotas en ese ancho e informa al usuario.
  3. store/app.json (consulta docs/config-reference.md), luego ejecuta python3 scripts/make_pack.py store/app.json. Enmarca las capturas sobre un degradado de marca con un pie de foto, construye un gráfico destacado e iconos, y ejecuta scripts/check_pack.py.
    • Icono: normalmente solo existe arte con esquinas redondeadas integradas o texto; el trabajo icon recorta la marca sobre un fondo plano sin sangría. Informa al usuario de que aún se necesita un vector o una fuente limpia de 1024 px.
  4. Texto de ficha: store/listings.json, luego python3 scripts/write_listings.py store/listings.json (formato fastlane, límites aplicados). Describe solo lo que realmente hace la compilación y lo que incluye la compilación de la plataforma.
  5. Documentación: store/README.md (tabla de bloqueos primero), google-play/console-forms.md, app-store/connect-forms.md.

Especificaciones de las tiendas (confírmalas en las consolas; la página de Apple puede no cargar)

  • Play: icono 512 px (<= 1 MB); gráfico destacado 1024x500, sin alfa; 2-8 capturas de teléfono, cada lado 320-3840 px y lado largo <= 2x lado corto (usa 1080x1920); opcionalmente capturas de tableta 7"/10" (1200x1920, 1600x2560); título 30, corto 80, completo 4000.
  • App Store: iPhone 6.9" 1320x2868 (obligatorio), 6.5" 1284x2778; iPad 13" 2064x2752 si se admite iPad; hasta 10 cada una; sin alfa; icono 1024 px, sin alfa; nombre 30, subtítulo 30, promo 170, palabras clave 100.
  • Ambas rechazan capturas con canal alfa; el compositor escribe PNG RGB.

Bloqueos a buscar en cada aplicación (aprendidos)

  • Pagos: vender desbloqueos digitales o licencias a través de un proveedor de pagos web dentro de la aplicación infringe las reglas de Play Billing / Apple IAP. Para iOS, envía sin interfaz de compra o añade StoreKit. Sin precios ni enlaces de compra en compilaciones móviles.
  • Eliminación de cuenta: cualquier aplicación que cree cuentas necesita una ruta de eliminación dentro de la aplicación y (Play) una URL web pública que la describa.
  • Inicio de sesión con Apple: obligatorio siempre que se ofrezca inicio de sesión con Google u otros terceros en iOS.
  • IDs de anuncios de prueba dejados en una versión de lanzamiento; IDs reales faltantes.
  • Play App Signing: añade el SHA-1 de firma de Play a los clientes de OAuth de Android, o el inicio de sesión fallará en instalaciones desde Play.
  • Permisos restringidos o declarados: REQUEST_IGNORE_BATTERY_OPTIMIZATIONS, tipos de servicio en primer plano (necesitan declaración y un video), ubicación (incluso con maxSdkVersion), Bluetooth neverForLocation.
  • Acceso del revisor: las aplicaciones que necesitan un servidor o licencia necesitan un servidor de demostración, PIN y pasos (Acceso a la aplicación de Play, directriz de Apple 2.1).
  • La URL de la política de privacidad debe existir; dirección de contacto y teléfono para el estado de comerciante (UE/REINO UNIDO).
  • Firma de lanzamiento configurada; aumento de versión; AAB para Play; equipo de Apple y bundle ID; ITSAppUsesNonExemptEncryption; manifiesto de privacidad.
  • Nuevas cuentas personales de Play: se requiere una prueba cerrada de 14 días con 12 probadores antes de la producción.
  • Seguridad de datos: "procesado efímeramente" solo para datos usados en memoria y nunca almacenados (por ejemplo, una foto enviada a un servicio de IA); el correo electrónico o los ID guardados en un servidor no son efímeros. ID de publicidad: responde "No" solo si no hay SDK de anuncios o conversión presente y se ha eliminado el permiso de ID de publicidad.
  • Audiencia objetivo mayores de 18 años a menos que la aplicación sea realmente para niños.
  • Un shrinker de tamaño mínimo (R8) puede fallar en bibliotecas opcionales: si una compilación de lanzamiento falla con "Missing classes", añade reglas -dontwarn para los paquetes nombrados.

Archivos

  • scripts/make_pack.py lo ejecuta todo; scripts/compose/ es el compositor de Flutter (STORE_JOBS=jobs.json flutter test); scripts/build_icons.py; scripts/check_pack.py; scripts/write_listings.py.
  • templates/app.example.json, templates/listings.example.json - configuraciones para copiar. examples/ - un ejemplo completo con una aplicación ficticia y su resultado.
  • docs/ - introducción, referencia de configuración, cómo funciona.

Skills relacionados