agentleFS
angelgabrieljacintohuayllascoangelgabrieljacintohuayllasco/clipboard-skills/skills/mobile-app/SKILL.md

mobile-app

Skill0 starsChanged 42 days agoMITView on GitHub

Build or ship a mobile app or APK: Android/iOS, Kotlin, Swift, React Native, Flutter, Capacitor. \"app para el celular\", \"genera el APK\", Play Store, push, permissions. Use with ui-design.

Files
SKILL.md

Mobile-App — el entorno más hostil en el que va a correr tu código

Overview

Un teléfono es un entorno hostil: red intermitente, batería limitada, el sistema mata tu proceso cuando quiere, la pantalla es chica, los permisos los concede (o niega) el usuario, y el paquete que publicas es leíble por cualquiera. Además, publicar tiene reglas de terceros con fechas límite: versiones mínimas del sistema, formatos de empaquetado, declaraciones de privacidad, requisitos técnicos que cambian cada año.

Lo que en web es un ajuste rápido, aquí es una versión nueva que la gente puede no instalar nunca.

Cuándo usar

  • Construir o ampliar una aplicación móvil, nativa o híbrida.
  • Generar, firmar o publicar un paquete.
  • Permisos, notificaciones, almacenamiento local, trabajo sin conexión.
  • Preparar una publicación en tienda o una distribución directa.

Cuándo NO usar

SituaciónRuta
Sitio web que se ve en móvilweb-app
Aplicación de escritoriodesktop-app
API que consume la appapi-backend
Algo se ve mal en pantallaui-bug

Diseño visual

Toda pantalla nueva o rediseñada aplica ui-design antes de darse por terminada: tokens de tipografía, espaciado y color definidos primero, cero emojis, un solo set de iconos SVG, y verificación con capturas en un teléfono chico y uno grande. Una interfaz que funciona pero parece plantilla generada por IA no está lista.

Regla de hierro: el paquete es público

TODO LO QUE VIAJA DENTRO DEL APK/IPA ES LEIBLE: CLAVES, ENDPOINTS, LOGICA, TEXTOS. NINGUN SECRETO VIVE AHI.

Cualquiera puede descomprimir el paquete y leerlo. Las claves de servicios de pago, bases de datos o APIs privilegiadas viven en tu servidor; la app solo habla con tu servidor. Las validaciones de negocio que importan se hacen del lado del servidor: la app se puede modificar.

Decisiones tempranas

DecisiónCriterio
Nativo vs multiplataforma¿Usa capacidades del sistema a fondo o es principalmente pantallas y datos? ¿Quién la mantendrá?
Tienda vs distribución directaLa tienda impone requisitos y revisiones, pero da confianza, actualizaciones y alcance. Instalar un archivo a mano exige que el usuario baje sus defensas — mala señal para un producto público
Versión mínima del sistemaCubre a tus usuarios reales, no a todos los teléfonos del mundo
Sin conexión¿Solo lectura en caché, o crear y editar y sincronizar después? Cambia toda la arquitectura
Notificaciones¿De verdad hacen falta? Traen infraestructura, permisos y fatiga del usuario

Antes de empezar a construir, verifica los requisitos vigentes de la tienda (versión mínima del sistema objetivo, formato de publicación, requisitos técnicos del empaquetado, declaración de datos y privacidad) y sus fechas límite. Cambian todos los años y bloquean publicaciones sin aviso útil.

Construcción

Ciclo de vida y recursos

  • El sistema puede suspender o matar la app en cualquier momento: guarda el estado, restaura al volver.
  • Nada de trabajo pesado en el hilo principal; una interfaz que traba se siente rota.
  • Cuidar batería y datos: nada de sondeos constantes, de ubicación continua sin motivo ni de descargas en red móvil sin avisar.
  • Probar en gama baja, no solo en el mejor teléfono disponible.

Red intermitente

  • Asume caída en mitad de la petición: tiempos límite, reintentos con retardo creciente, mensajes claros.
  • Diferencia "sin conexión" de "el servidor falló": el usuario necesita saber si esperar o reintentar.
  • Cola de acciones pendientes si la app permite crear datos sin conexión, con sincronización idempotente.

Permisos

  • Pedir en el momento en que se usan, explicando para qué, no todos al abrir.
  • Funcionar de forma degradada si el usuario niega; nunca bloquear la app entera.
  • Pedir el mínimo: cada permiso sensible es fricción, riesgo de rechazo en tienda y desconfianza.

Almacenamiento

  • Datos sensibles en el almacén cifrado del sistema, no en preferencias planas ni en archivos sueltos.
  • Base local con migraciones versionadas y probadas desde la versión publicada anterior.
  • Limitar el crecimiento de cachés: llenar el teléfono es motivo de desinstalación.

Interfaz

  • Área segura, teclado que tapa campos, rotación, texto grande por accesibilidad, modo oscuro si el sistema lo pide.
  • Áreas táctiles cómodas; navegación con el botón atrás coherente.
  • Estados de carga/vacío/error en cada pantalla que trae datos.

Publicación

PasoDetalle
FirmaClave de firma generada, respaldada fuera del equipo y nunca en el repositorio. Perderla puede significar perder la app publicada
VersionadoCódigo de versión incremental + nombre visible; trazable al commit
Requisitos técnicosVersión objetivo del sistema y formato de empaquetado vigentes, verificados antes de enviar
PrivacidadDeclaración de datos recolectados coherente con lo que la app hace de verdad
Prueba en dispositivo realAl menos uno físico, de gama baja
Publicación escalonadaPor porcentaje, mirando errores y reseñas antes de completar
Compatibilidad del servidorLas versiones viejas siguen ahí: el backend no puede romperlas
Interruptores remotosApagar una funcionalidad rota sin publicar versión nueva

Gate específico de móvil

ChequeoQué verifica
Construcción de release firmadaCompila, firma y se instala
Instalación limpia + actualización sobre versión anteriorMigración de datos incluida
Sin secretos en el paqueteEscaneo del artefacto, no solo del repo
Permisos declarados = permisos usadosNada de más
Modo avión / red lentaComportamiento definido
Ciclo de vidaSuspender, matar y restaurar sin perder estado
Pruebas de interfaz de los caminos críticosEn emulador y en un dispositivo real
Tamaño del paqueteCon trinquete: no crece sin motivo

Anti-racionalización

ExcusaRealidad
"Guardo la clave de la API en la app, está compilada"Compilado no es cifrado. Se extrae en minutos.
"Pido todos los permisos al inicio, es más fácil"Aumenta rechazos de tienda y desinstalaciones, y no lo necesitas.
"Probé en el emulador, alcanza"El emulador no tiene red mala, batería, ni el sistema matándote la app.
"Si hay un bug publico otra versión"La revisión tarda y la gente no actualiza. Interruptores remotos y publicación escalonada.
"La validación la hago en la app"La app la controla el usuario. La validación real vive en el servidor.
"Genero el APK y que lo instalen a mano"Válido para pruebas internas. Para un producto público, pides al usuario que ignore las advertencias de seguridad de su teléfono.

Formato de salida

  • Plataformas y versiones mínimas soportadas.
  • Permisos solicitados y justificación de cada uno.
  • Comportamiento sin conexión y estrategia de sincronización.
  • Resultado del gate, incluido el escaneo de secretos sobre el paquete final.
  • Estado de firma, respaldo de la clave y plan de publicación.
  • Requisitos de tienda verificados con fecha de verificación.

Download now (ZIP)

  • Other versions8 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 8

    1. popup-studio-ai/bkit-claude-code★ 605same name
    2. ww-w-ai/bkit-claude-code★ 605same name
    3. ww-w-ai/bkit-codex★ 69same name
    4. ww-w-ai/bkit-gemini★ 66same name
    5. deonmenezes/mobile-app-skill★ 4same name
    6. HarishChandran3304/mobile-app★ 1same name
    7. jpoindexter/theft-kit★ 1same name
    8. ThuPhuong1010/claude-factory★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • Used alongsideProjects with it also use pm-discovery, qa-phase and 6 more.

    Other files people use alongside this one.

    Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
    • ww-w-aiSkill

      pm-discovery

      PM Agent Team - Automated product discovery, strategy, and PRD generation. Runs PM analysis workflow to produce comprehensive PRD before PDCA Plan phase.

      Also in 3 projects that use this

    • ww-w-aiSkill

      qa-phase

      Run QA tests at various levels (L1-L5) for features under PDCA management. Integrates with MCP tools to execute structured test plans.

      Also in 3 projects that use this

    • kannaka-labsSkill

      skill-status

      Show where you are in the workflow and what to do next — use for progress checks and orientation. Use when: AUTOMATICALLY ACTIVATE when user asks about:. \"status\" or \"progress\" or \"where am I\". \"what's next\" or \"next step\"

      Also in 3 projects that use this

    • dacryptSkill

      control

      Control your Tesla — lock, unlock, climate, trunk, horn, flash, windows, sentry mode, charge port, speed limit. Use when someone says "lock my car", "turn on the AC", "open the trunk", "honk the horn", etc.

      Also in 3 projects that use this

    • launch52-aiSkill

      skill-create

      Create and validate Claude Code skills with proper structure, checklists, and validation scripts. Use when creating a new skill, auditing existing skills, or ensuring skills meet quality standards. Generates complete skill scaffolds with SKILL.md, check scripts, guides, and templates.

      Also in 3 projects that use this

    • OpenAISkill

      audit

      Audit or critique a product flow, journey, workflow, funnel, onboarding path, checkout path, settings path, screen, or multi-step product experience by capturing screenshots first, then reporting UX, design, and accessibility findings inline from that evidence. Use Figma only when the user explicitly asks for a board. Use when the user asks to audit, review, critique, inspect, assess, analyze, evaluate, or give feedback on a product experience.

      Also in 3 projects that use this

    • +2 more from ww-w-ai
  • In this repository37 other files it gives its agents.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.