Habilidades firebase-development-debug
📦

firebase-development-debug

Riesgo medio ⚙️ Comandos externos🌐 Acceso a red📁 Acceso al sistema de archivos🔑 Variables de entorno

Depurar Problemas de Desarrollo con Firebase

Los fallos en el desarrollo con Firebase pueden ser difíciles de aislar entre emuladores, reglas, funciones, autenticación y despliegue. Esta skill guía un flujo de trabajo de depuración estructurado con comprobaciones enfocadas y soluciones repetibles.

Soporta: Claude Codex Code(CC)
⚠️ 50 Deficiente
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Recursos legibles por agentes

Usa estos enlaces cuando un AI Agent, crawler o script necesite contexto limpio en lugar de leer toda la página.

Detalle Markdown GET /skills/2389-research-firebase-development-debug.md Manifest firmado GET /api/skills/2389-research-firebase-development-debug/manifest Lockfile firmado GET /api/skills/2389-research-firebase-development-debug/lockfile

Pruébalo

Usando "firebase-development-debug". Mi emulador informa que un puerto ya está en uso.

Resultado esperado:

  • Identifica esto como un problema de inicio del emulador.
  • Comprueba el puerto afectado y el proceso en ejecución antes de cualquier paso de terminación.
  • Recomienda exportar o conservar los datos del emulador antes de reiniciar cuando sea relevante.

Usando "firebase-development-debug". Una escritura de cliente en Firestore falla con permiso denegado.

Resultado esperado:

  • Clasifica el problema como un problema de reglas o autenticación.
  • Guía una simulación en Rules Playground con operación, ruta, contexto de autenticación y datos de la solicitud.
  • Separa el comportamiento de Admin SDK de la aplicación de reglas en client SDK.

Usando "firebase-development-debug". Firebase deploy falla después de que se ejecuta un hook predeploy.

Resultado esperado:

  • Revisa los registros de depuración y la configuración del proyecto Firebase.
  • Ejecuta el paso de compilación localmente para aislar el hook que falla.
  • Documenta la causa raíz y las notas de prevención después de la solución.

Auditoría de seguridad

Riesgo medio
v4 • 6/27/2026

Static analysis found shell commands, localhost network access, and environment-file inspection guidance. Review confirms these are mostly legitimate Firebase debugging instructions, but reading .env files and killing processes creates elevated operational risk. No evidence found of malicious exfiltration, prompt injection, or hidden executable payloads.

1
Archivos escaneados
183
Líneas analizadas
9
hallazgos
4
Auditorías totales
Problemas de riesgo medio (2)
SKILL.md:55-58SKILL.md:114-123SKILL.md:129-142SKILL.md:161-167
Shell and Process Management Commands in Debug Workflow
The skill recommends shell commands for port checks, process termination, Firebase emulator control, exports, and build checks. These commands are normal for Firebase debugging, but they can disrupt local services or change emulator state if run without review. Verdict: true positive for operational command risk, not evidence of malicious execution.
SKILL.md:103-105
Sensitive Environment File Inspection Guidance
The skill tells the agent to read functions/.env and hosting/.env.local while diagnosing auth configuration. This is a legitimate troubleshooting step, but it may expose secrets in the AI context or logs. Verdict: true positive for sensitive file access risk.
Problemas de riesgo bajo (3)
SKILL.md:66-67
Localhost Network URL Flag Is Low Risk
The hardcoded URL points to 127.0.0.1 for the Firebase Emulator UI. This supports local debugging and does not indicate external communication. Verdict: false positive for external network risk.
SKILL.md:3SKILL.md:10SKILL.md:45
Descriptive Text Triggered Heuristic False Positives
The weak cryptographic algorithm and system reconnaissance flags map to descriptive Firebase debugging text, not cryptographic calls or host reconnaissance code. Verdict: false positive for these blocker findings.
SKILL.md:28-30SKILL.md:60-62SKILL.md:85-98SKILL.md:110SKILL.md:151SKILL.md:172-181
Reference Backticks Are Not Command Execution
Several static command findings point to backticked skill names and documentation paths. These references do not execute code by themselves. Verdict: false positive for Ruby or shell backtick execution on these lines.

Factores de riesgo

⚙️ Comandos externos (7)
SKILL.md:55-58 SKILL.md:66-67 SKILL.md:103-105 SKILL.md:114-123 SKILL.md:129-135 SKILL.md:140-142 SKILL.md:161-167
🌐 Acceso a red (1)
SKILL.md:66-67
📁 Acceso al sistema de archivos (4)
SKILL.md:103-105 SKILL.md:114-117 SKILL.md:135 SKILL.md:151
🔑 Variables de entorno (2)
SKILL.md:103-105 SKILL.md:167

Patrones detectados

Command Guidance Combined With Secret File Reads
Auditado por: codex Ver historial de auditorías →

Puntuación de calidad

55
Arquitectura
100
Mantenibilidad
87
Contenido
70
Comunidad
49
Seguridad
83
Cumplimiento de la especificación

Lo que puedes crear

Resolver Fallos de Inicio del Emulador

Diagnosticar conflictos de puertos, errores de inicialización del emulador y pérdida de estado del emulador local.

Depurar Errores de Reglas y Autenticación

Rastrear errores de permiso denegado mediante el contexto de autenticación, los datos de la solicitud y la simulación en Rules Playground.

Investigar Roturas de Despliegue

Comprobar registros de despliegue de Firebase, configuración del proyecto, destinos y pasos de compilación predeploy.

Prueba estos prompts

Clasifica Mi Error de Firebase 
Tengo un error de desarrollo de Firebase. Ayúdame a clasificar si está relacionado con emulador, reglas, funciones, autenticación o despliegue.
Depurar Inicio del Emulador 
Mis emuladores de Firebase no arrancan. Guíame por comprobaciones seguras de puertos, registros y estado del emulador antes de reiniciar.
Rastrear Permiso Denegado 
Una solicitud de Firestore devuelve PERMISSION_DENIED. Ayúdame a probar el contexto de autenticación, los datos de la solicitud y la evaluación de reglas.
Investigar Fallo de Despliegue 
Mi despliegue de Firebase falla con una salida poco clara. Crea un plan de diagnóstico que cubra registros, firebase.json, destinos y hooks predeploy.

Mejores prácticas

  • Confirma la categoría del problema antes de ejecutar comandos o cambiar la configuración.
  • Redacta los secretos antes de compartir contenido de archivos de entorno o registros de depuración.
  • Exporta el estado del emulador antes de reinicios que podrían eliminar datos de prueba locales.

Evitar

  • Terminar procesos sin confirmar el propietario del proceso y el contexto del proyecto.
  • Pegar el contenido completo de .env en chats o rastreadores de incidencias sin redacción.
  • Cambiar reglas, autenticación y código de funciones al mismo tiempo durante el diagnóstico.

Preguntas frecuentes

¿Qué problemas de Firebase cubre esta skill?
Cubre fallos de inicio del emulador, reglas de Firestore, Cloud Functions, emulador de Auth y despliegue.
¿Ejecuta comandos de Firebase automáticamente?
Proporciona orientación sobre comandos. Los usuarios deben revisar los comandos antes de ejecutarlos, especialmente los comandos de terminación de procesos.
¿Es seguro inspeccionar archivos .env?
Inspecciónalos solo cuando sea necesario y redacta los secretos antes de compartir la salida con cualquier herramienta de IA o colaborador.
¿Puede depurar incidentes de Firebase en producción?
Está diseñada para flujos de trabajo de desarrollo. Los incidentes de producción necesitan un control de acceso más estricto y procedimientos de incidentes.
¿Ayuda con las reglas de Firestore?
Sí. Recomienda comprobaciones en Rules Playground con tipo de operación, ruta del documento, contexto de autenticación y datos de la solicitud.
¿Qué herramientas pueden usar esta skill?
Está listada para Claude, Codex y Claude Code.

Detalles del desarrollador

Licencia

MIT

Repositorio

https://github.com/2389-research/claude-plugins/tree/main/firebase-development/skills/debug

Ref.

main

Estructura de archivos

📄 SKILL.md