aiskillstore/marketplace / skills/2389-research/firebase-development-debug
firebase-development-debug
VerifiedThis skill should be used when troubleshooting Firebase emulator issues, rules violations, function errors, auth problems, or deployment failures. Triggers on "error", "not working", "debug", "troubleshoot", "failing", "broken", "permission denied", "emulator issue".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.6 KB |
| skill-report.json | config | 44.7 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-04T17:54:12.000Z",
"slug": "2389-research-firebase-development-debug",
"source_url": "https://github.com/2389-research/claude-plugins/tree/main/firebase-development/skills/debug",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "3c3f3cc3b6082fe2cd422a77bd524d9bb8b4d820ad9c140b21dc33387a121868",
"tree_hash": "564c279beb8a73138734aeddec18a722a28794fc24d0aada204b3d9568f796a2",
"provenance": {
"model_requested": "gpt-5.5:high",
"model_effective": "codex:gpt-5.5:high",
"fallback_chain": [
{
"agent": "codex",
"model": "gpt-5.5",
"effort": "high",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "firebase-development-debug",
"description": "Troubleshoot Firebase emulator, rules, auth, function, and deployment failures with a structured debugging workflow.",
"summary": "Guides Firebase developers through repeatable debugging steps for local emulators, rules, auth, functions, and deployments.",
"icon": "📦",
"version": "1.0.0",
"author": "2389-research",
"license": "MIT",
"tags": [
"firebase",
"debugging",
"emulators",
"firestore-rules",
"cloud-functions"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"external_commands",
"network",
"filesystem"
],
"category": "devops"
},
"security_audit": {
"risk_level": "high",
"is_blocked": false,
"safe_to_publish": false,
"analysis_status": "ok",
"summary": "Most static command findings are Markdown examples or references for Firebase debugging. The real security concern is direct guidance to read .env files, which can expose credentials to the agent or logs.",
"remediation": [
{
"issue": "Direct environment file reads can expose secrets.",
"suggestion": "Replace cat commands with guidance to inspect only required variable names and redact values before sharing output.",
"severity": "high"
},
{
"issue": "Process termination guidance can stop unrelated local services.",
"suggestion": "Ask the user to confirm the PID and prefer graceful termination before using kill -9.",
"severity": "medium"
},
{
"issue": "Build and Firebase CLI commands may run project scripts or reveal project metadata.",
"suggestion": "State that commands should run only in trusted repositories and after user approval.",
"severity": "medium"
}
],
"risk_factor_evidence": [
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 28,
"line_end": 28
},
{
"file": "SKILL.md",
"line_start": 29,
"line_end": 29
},
{
"file": "SKILL.md",
"line_start": 30,
"line_end": 30
},
{
"file": "SKILL.md",
"line_start": 55,
"line_end": 58
},
{
"file": "SKILL.md",
"line_start": 58,
"line_end": 60
},
{
"file": "SKILL.md",
"line_start": 60,
"line_end": 62
},
{
"file": "SKILL.md",
"line_start": 62,
"line_end": 66
},
{
"file": "SKILL.md",
"line_start": 66,
"line_end": 68
},
{
"file": "SKILL.md",
"line_start": 68,
"line_end": 85
},
{
"file": "SKILL.md",
"line_start": 85,
"line_end": 98
},
{
"file": "SKILL.md",
"line_start": 98,
"line_end": 103
},
{
"file": "SKILL.md",
"line_start": 103,
"line_end": 106
},
{
"file": "SKILL.md",
"line_start": 106,
"line_end": 110
},
{
"file": "SKILL.md",
"line_start": 110,
"line_end": 114
},
{
"file": "SKILL.md",
"line_start": 114,
"line_end": 119
},
{
"file": "SKILL.md",
"line_start": 119,
"line_end": 122
},
{
"file": "SKILL.md",
"line_start": 122,
"line_end": 124
},
{
"file": "SKILL.md",
"line_start": 124,
"line_end": 129
},
{
"file": "SKILL.md",
"line_start": 129,
"line_end": 133
},
{
"file": "SKILL.md",
"line_start": 133,
"line_end": 135
},
{
"file": "SKILL.md",
"line_start": 135,
"line_end": 140
},
{
"file": "SKILL.md",
"line_start": 140,
"line_end": 142
},
{
"file": "SKILL.md",
"line_start": 142,
"line_end": 151
},
{
"file": "SKILL.md",
"line_start": 151,
"line_end": 161
},
{
"file": "SKILL.md",
"line_start": 161,
"line_end": 166
},
{
"file": "SKILL.md",
"line_start": 166,
"line_end": 167
},
{
"file": "SKILL.md",
"line_start": 167,
"line_end": 172
},
{
"file": "SKILL.md",
"line_start": 172,
"line_end": 179
},
{
"file": "SKILL.md",
"line_start": 179,
"line_end": 180
},
{
"file": "SKILL.md",
"line_start": 180,
"line_end": 181
},
{
"file": "SKILL.md",
"line_start": 181,
"line_end": 182
}
]
},
{
"factor": "network",
"evidence": [
{
"file": "SKILL.md",
"line_start": 67,
"line_end": 67
},
{
"file": "SKILL.md",
"line_start": 67,
"line_end": 67
}
]
},
{
"factor": "filesystem",
"evidence": [
{
"file": "SKILL.md",
"line_start": 104,
"line_end": 104
},
{
"file": "SKILL.md",
"line_start": 105,
"line_end": 105
}
]
}
],
"static_findings": [
{
"id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 28,
"line_end": 28,
"snippet": "- Setting up new projects → `firebase-development:project-setup`"
},
{
"id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 29,
"line_end": 29,
"snippet": "- Adding new features → `firebase-development:add-feature`"
},
{
"id": "external_commands:SKILL.md:30:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 30,
"line_end": 30,
"snippet": "- Code review without specific errors → `firebase-development:validate`"
},
{
"id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 55,
"line_end": 58,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 58,
"line_end": 60,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:60:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 60,
"line_end": 62,
"snippet": "**For deployment errors:** Check `firebase-debug.log`"
},
{
"id": "external_commands:SKILL.md:62:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 62,
"line_end": 66,
"snippet": "**Reference:** `docs/examples/emulator-workflow.md`"
},
{
"id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 66,
"line_end": 68,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 68,
"line_end": 85,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:85:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 85,
"line_end": 98,
"snippet": "**Reference:** `docs/examples/firestore-rules-patterns.md`"
},
{
"id": "external_commands:SKILL.md:98:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 98,
"line_end": 103,
"snippet": "**Reference:** `docs/examples/express-function-architecture.md`"
},
{
"id": "external_commands:SKILL.md:103:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 103,
"line_end": 106,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:106:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 106,
"line_end": 110,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:110:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 110,
"line_end": 114,
"snippet": "**Reference:** `docs/examples/api-key-authentication.md`"
},
{
"id": "external_commands:SKILL.md:114:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 114,
"line_end": 119,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 119,
"line_end": 122,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:122:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 122,
"line_end": 124,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 124,
"line_end": 129,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 129,
"line_end": 133,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:133:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 133,
"line_end": 135,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:135:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 135,
"line_end": 140,
"snippet": "Verify export: `ls -la .firebase/emulator-data/`"
},
{
"id": "external_commands:SKILL.md:140:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 140,
"line_end": 142,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:142:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 142,
"line_end": 151,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 151,
"line_end": 161,
"snippet": "Create entry in `docs/debugging-notes.md`:"
},
{
"id": "external_commands:SKILL.md:161:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 161,
"line_end": 166,
"snippet": "| Port conflicts | `lsof -i :<port>`, kill process |"
},
{
"id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 166,
"line_end": 167,
"snippet": "| Missing CORS | Add `app.use(cors({ origin: true }))` |"
},
{
"id": "external_commands:SKILL.md:167:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 167,
"line_end": 172,
"snippet": "| Emulator connection | Set `NEXT_PUBLIC_USE_EMULATORS=true` |"
},
{
"id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 172,
"line_end": 179,
"snippet": "If Firebase-specific tools don't reveal root cause, invoke `superpowers:systematic-debugging` for:"
},
{
"id": "external_commands:SKILL.md:179:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 179,
"line_end": 180,
"snippet": "- **Emulator workflow:** `docs/examples/emulator-workflow.md`"
},
{
"id": "external_commands:SKILL.md:180:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 180,
"line_end": 181,
"snippet": "- **Rules patterns:** `docs/examples/firestore-rules-patterns.md`"
},
{
"id": "external_commands:SKILL.md:181:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 181,
"line_end": 182,
"snippet": "- **Auth patterns:** `docs/examples/api-key-authentication.md`"
},
{
"id": "network:SKILL.md:67:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 67,
"line_end": 67,
"snippet": "open http://127.0.0.1:4000"
},
{
"id": "network:SKILL.md:67:hardcoded-ip-address",
"category": "network",
"severity": "medium",
"pattern": "Hardcoded IP address",
"file": "SKILL.md",
"line_start": 67,
"line_end": 67,
"snippet": "open http://127.0.0.1:4000"
},
{
"id": "filesystem:SKILL.md:104:hidden-file-access",
"category": "filesystem",
"severity": "medium",
"pattern": "Hidden file access",
"file": "SKILL.md",
"line_start": 104,
"line_end": 104,
"snippet": "cat functions/.env"
},
{
"id": "filesystem:SKILL.md:105:hidden-file-access",
"category": "filesystem",
"severity": "medium",
"pattern": "Hidden file access",
"file": "SKILL.md",
"line_start": 105,
"line_end": 105,
"snippet": "cat hosting/.env.local # Should have NEXT_PUBLIC_USE_EMULATORS=true"
},
{
"id": "sensitive:SKILL.md:104:environment-file-access",
"category": "sensitive",
"severity": "high",
"pattern": "Environment file access",
"file": "SKILL.md",
"line_start": 104,
"line_end": 104,
"snippet": "cat functions/.env"
},
{
"id": "sensitive:SKILL.md:105:environment-file-access",
"category": "sensitive",
"severity": "high",
"pattern": "Environment file access",
"file": "SKILL.md",
"line_start": 105,
"line_end": 105,
"snippet": "cat hosting/.env.local # Should have NEXT_PUBLIC_USE_EMULATORS=true"
},
{
"id": "sensitive:SKILL.md:105:environment-variant-files",
"category": "sensitive",
"severity": "high",
"pattern": "Environment variant files",
"file": "SKILL.md",
"line_start": 105,
"line_end": 105,
"snippet": "cat hosting/.env.local # Should have NEXT_PUBLIC_USE_EMULATORS=true"
},
{
"id": "blocker:SKILL.md:45:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 45,
"line_end": 45,
"snippet": "| Auth Issue | Token errors, not authenticated | \"auth failed\", \"invalid token\" |"
}
],
"finding_verdicts": [
{
"id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This is an inline reference to another Firebase skill name. It is not shell syntax and does not execute a command."
},
{
"id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This is an inline reference to another Firebase skill name. It is not shell syntax and does not execute a command."
},
{
"id": "external_commands:SKILL.md:30:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This is an inline reference to another Firebase skill name. It is not shell syntax and does not execute a command."
},
{
"id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
"verdict": "confirmed",
"confidence": 0.74,
"severity": "medium",
"reason": "The fenced command block includes port inspection and kill -9 guidance. It is legitimate troubleshooting, but an incorrect PID can terminate unrelated local processes."
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "This points to the end of a Markdown code fence and a log filename mention. It is not executable code by itself."
},
{
"id": "external_commands:SKILL.md:60:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The backticks surround the firebase-debug.log filename for documentation. No command execution is requested on this line."
},
{
"id": "external_commands:SKILL.md:62:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The backticks identify a documentation path. It is a local reference, not a shell command."
},
{
"id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "The command opens the loopback Firebase Emulator UI in a browser. It is local diagnostic guidance and not arbitrary command execution."
},
{
"id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "This points to the closing Markdown fence and explanatory UI text. It does not introduce executable behavior."
},
{
"id": "external_commands:SKILL.md:85:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The backticks identify a documentation path for Firestore rules patterns. It is a reference, not command execution."
},
{
"id": "external_commands:SKILL.md:98:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The backticks identify a documentation path for function architecture. It is a reference, not command execution."
},
{
"id": "external_commands:SKILL.md:103:ruby-shell-backtick-execution",
"verdict": "confirmed",
"confidence": 0.86,
"severity": "high",
"reason": "The fenced commands instruct reading .env files. Those files commonly contain credentials, so displaying them to an agent can expose secrets."
},
{
"id": "external_commands:SKILL.md:106:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "This points to the closing Markdown fence and general configuration text. The risky environment file reads are covered by their own findings."
},
{
"id": "external_commands:SKILL.md:110:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The backticks identify a documentation path for API key authentication. It is a reference, not command execution."
},
{
"id": "external_commands:SKILL.md:114:ruby-shell-backtick-execution",
"verdict": "confirmed",
"confidence": 0.6,
"severity": "medium",
"reason": "The fenced block asks the agent to read deployment config and run Firebase CLI inspection. This is legitimate debugging but can reveal project metadata."
},
{
"id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "This points to a closing Markdown code fence. The preceding deployment inspection commands are addressed in the related finding."
},
{
"id": "external_commands:SKILL.md:122:ruby-shell-backtick-execution",
"verdict": "confirmed",
"confidence": 0.72,
"severity": "medium",
"reason": "The npm run build instruction executes project-defined scripts. This is common development work, but it can run arbitrary local build hooks."
},
{
"id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "This points to a closing Markdown code fence. The build command risk is covered by the adjacent finding."
},
{
"id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.82,
"reason": "The command exports local Firebase emulator state as a backup. It is scoped to the project and does not access secrets or external hosts."
},
{
"id": "external_commands:SKILL.md:133:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "This points to a closing Markdown code fence after an emulator export example. It is not executable by itself."
},
{
"id": "external_commands:SKILL.md:135:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "The inline ls command verifies a local emulator data directory. It is read-only directory inspection and appears appropriate for debugging."
},
{
"id": "external_commands:SKILL.md:140:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.84,
"reason": "The command starts Firebase emulators from local backup data. It is standard local development guidance without secret access or exfiltration."
},
{
"id": "external_commands:SKILL.md:142:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "This points to a closing Markdown code fence after an emulator start example. It is not executable by itself."
},
{
"id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.92,
"reason": "The backticks identify a documentation note path. Creating a debugging note is not shell execution."
},
{
"id": "external_commands:SKILL.md:161:ruby-shell-backtick-execution",
"verdict": "confirmed",
"confidence": 0.7,
"severity": "medium",
"reason": "The quick reference repeats lsof and process-kill guidance. It is useful for port conflicts but can terminate the wrong process if followed carelessly."
},
{
"id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The inline text is an Express CORS code example, not a shell command. It does not execute anything in the skill."
},
{
"id": "external_commands:SKILL.md:167:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.91,
"reason": "The backticks identify an environment variable name. Naming a variable is not command execution or secret access."
},
{
"id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "The text references another debugging skill by name. It is a workflow handoff, not shell execution."
},
{
"id": "external_commands:SKILL.md:179:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The backticks identify a local documentation path. It is a reference, not command execution."
},
{
"id": "external_commands:SKILL.md:180:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The backticks identify a local documentation path. It is a reference, not command execution."
},
{
"id": "external_commands:SKILL.md:181:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The backticks identify a local documentation path. It is a reference, not command execution."
},
{
"id": "network:SKILL.md:67:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The URL is the Firebase Emulator UI on 127.0.0.1. It targets loopback only and does not contact an external network service."
},
{
"id": "network:SKILL.md:67:hardcoded-ip-address",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The hardcoded IP address is 127.0.0.1 for a local emulator UI. Loopback access is expected for Firebase development diagnostics."
},
{
"id": "filesystem:SKILL.md:104:hidden-file-access",
"verdict": "confirmed",
"confidence": 0.9,
"severity": "high",
"reason": "The instruction reads functions/.env directly. Hidden environment files commonly hold secrets and should not be displayed wholesale to an agent."
},
{
"id": "filesystem:SKILL.md:105:hidden-file-access",
"verdict": "confirmed",
"confidence": 0.88,
"severity": "high",
"reason": "The instruction reads hosting/.env.local directly. Local environment files may include API keys or service endpoints that should be redacted."
},
{
"id": "sensitive:SKILL.md:104:environment-file-access",
"verdict": "confirmed",
"confidence": 0.93,
"severity": "high",
"reason": "The skill explicitly instructs cat functions/.env. Environment files often contain credentials, so this is a real secret exposure risk."
},
{
"id": "sensitive:SKILL.md:105:environment-file-access",
"verdict": "confirmed",
"confidence": 0.91,
"severity": "high",
"reason": "The skill explicitly instructs cat hosting/.env.local. Even public-prefixed variables should be reviewed selectively instead of dumping the file."
},
{
"id": "sensitive:SKILL.md:105:environment-variant-files",
"verdict": "confirmed",
"confidence": 0.9,
"severity": "high",
"reason": "The .env.local variant is a known local secret file pattern. Reading it directly creates a credible credential disclosure risk."
},
{
"id": "blocker:SKILL.md:45:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "Line 45 is a symptom table entry for auth errors. It contains no host enumeration, credential harvesting, or system reconnaissance instruction."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [
{
"title": "Ruby/shell backtick execution",
"description": "```bash",
"locations": [
{
"file": "SKILL.md",
"line_start": 103,
"line_end": 106
}
],
"review_kind": "capability",
"source_category": "external_commands",
"source_severity": "medium",
"confidence": 0.86,
"confidence_reasoning": "The fenced commands instruct reading .env files. Those files commonly contain credentials, so displaying them to an agent can expose secrets."
},
{
"title": "Hidden file access",
"description": "cat functions/.env",
"locations": [
{
"file": "SKILL.md",
"line_start": 104,
"line_end": 104
}
],
"review_kind": "capability",
"source_category": "filesystem",
"source_severity": "medium",
"confidence": 0.9,
"confidence_reasoning": "The instruction reads functions/.env directly. Hidden environment files commonly hold secrets and should not be displayed wholesale to an agent."
},
{
"title": "Hidden file access",
"description": "cat hosting/.env.local # Should have NEXT_PUBLIC_USE_EMULATORS=true",
"locations": [
{
"file": "SKILL.md",
"line_start": 105,
"line_end": 105
}
],
"review_kind": "capability",
"source_category": "filesystem",
"source_severity": "medium",
"confidence": 0.88,
"confidence_reasoning": "The instruction reads hosting/.env.local directly. Local environment files may include API keys or service endpoints that should be redacted."
},
{
"title": "Environment file access",
"description": "cat functions/.env",
"locations": [
{
"file": "SKILL.md",
"line_start": 104,
"line_end": 104
}
],
"review_kind": "security",
"source_category": "sensitive",
"source_severity": "high",
"confidence": 0.93,
"confidence_reasoning": "The skill explicitly instructs cat functions/.env. Environment files often contain credentials, so this is a real secret exposure risk."
},
{
"title": "Environment file access",
"description": "cat hosting/.env.local # Should have NEXT_PUBLIC_USE_EMULATORS=true",
"locations": [
{
"file": "SKILL.md",
"line_start": 105,
"line_end": 105
}
],
"review_kind": "security",
"source_category": "sensitive",
"source_severity": "high",
"confidence": 0.91,
"confidence_reasoning": "The skill explicitly instructs cat hosting/.env.local. Even public-prefixed variables should be reviewed selectively instead of dumping the file."
},
{
"title": "Environment variant files",
"description": "cat hosting/.env.local # Should have NEXT_PUBLIC_USE_EMULATORS=true",
"locations": [
{
"file": "SKILL.md",
"line_start": 105,
"line_end": 105
}
],
"review_kind": "security",
"source_category": "sensitive",
"source_severity": "high",
"confidence": 0.9,
"confidence_reasoning": "The .env.local variant is a known local secret file pattern. Reading it directly creates a credible credential disclosure risk."
}
],
"medium_findings": [
{
"title": "Ruby/shell backtick execution",
"description": "```bash",
"locations": [
{
"file": "SKILL.md",
"line_start": 55,
"line_end": 58
}
],
"review_kind": "capability",
"source_category": "external_commands",
"source_severity": "medium",
"confidence": 0.74,
"confidence_reasoning": "The fenced command block includes port inspection and kill -9 guidance. It is legitimate troubleshooting, but an incorrect PID can terminate unrelated local processes."
},
{
"title": "Ruby/shell backtick execution",
"description": "```bash",
"locations": [
{
"file": "SKILL.md",
"line_start": 114,
"line_end": 119
}
],
"review_kind": "capability",
"source_category": "external_commands",
"source_severity": "medium",
"confidence": 0.6,
"confidence_reasoning": "The fenced block asks the agent to read deployment config and run Firebase CLI inspection. This is legitimate debugging but can reveal project metadata."
},
{
"title": "Ruby/shell backtick execution",
"description": "```bash",
"locations": [
{
"file": "SKILL.md",
"line_start": 122,
"line_end": 124
}
],
"review_kind": "capability",
"source_category": "external_commands",
"source_severity": "medium",
"confidence": 0.72,
"confidence_reasoning": "The npm run build instruction executes project-defined scripts. This is common development work, but it can run arbitrary local build hooks."
},
{
"title": "Ruby/shell backtick execution",
"description": "| Port conflicts | `lsof -i :<port>`, kill process |",
"locations": [
{
"file": "SKILL.md",
"line_start": 161,
"line_end": 166
}
],
"review_kind": "capability",
"source_category": "external_commands",
"source_severity": "medium",
"confidence": 0.7,
"confidence_reasoning": "The quick reference repeats lsof and process-kill guidance. It is useful for port conflicts but can terminate the wrong process if followed carelessly."
}
],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 1,
"total_lines": 183,
"audit_model": "codex",
"audited_at": "2026-07-04T17:54:12.000Z",
"agent_auto_install_policy": "confirmation_required",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Debug Firebase Development Failures",
"value_statement": "Firebase failures often span emulators, rules, auth, functions, and deployment settings. This skill provides a structured workflow that narrows the cause and verifies the fix.",
"seo_keywords": [
"Firebase debugging",
"Firebase emulator",
"Firestore rules",
"Cloud Functions errors",
"Firebase auth troubleshooting",
"Firebase deployment",
"Claude",
"Codex",
"Claude Code",
"Firebase Emulator UI"
],
"actual_capabilities": [
"Classifies Firebase issues by emulator, rules, function, auth, or deployment symptoms.",
"Guides review of emulator logs, terminal output, and Firebase Emulator UI state.",
"Explains how to test Firestore rules with operation, path, auth context, and request data.",
"Suggests focused debug logging for function entry, inputs, auth context, and error details.",
"Checks deployment configuration, emulator state export, and post-fix verification steps."
],
"limitations": [
"It does not replace Firebase production monitoring or incident response tooling.",
"It requires access to the project, emulator output, and relevant error messages.",
"It cannot guarantee that local emulator behavior matches production behavior.",
"It may require careful redaction before environment or configuration details are shared."
],
"use_cases": [
{
"title": "Resolve Emulator Startup Problems",
"description": "Identify port conflicts, inspect emulator startup output, and restart services with saved local state.",
"target_user": "Local Firebase developer"
},
{
"title": "Diagnose Firestore Rule Denials",
"description": "Reproduce permission failures in the Rules Playground and compare auth context with expected access rules.",
"target_user": "Security rules maintainer"
},
{
"title": "Investigate Deployment Failures",
"description": "Review Firebase debug logs, project configuration, targets, and predeploy build behavior before retrying deployment.",
"target_user": "DevOps engineer"
}
],
"prompt_templates": [
{
"title": "Classify My Firebase Error",
"scenario": "Beginner triage when the cause is unclear.",
"prompt": "Help me classify this Firebase problem. Ask for the error text, the affected service, and the last action I took."
},
{
"title": "Debug Emulator Startup",
"scenario": "Local emulator issues with startup or port conflicts.",
"prompt": "Walk me through debugging a Firebase emulator startup failure. Include checks for ports, logs, and safe restart steps."
},
{
"title": "Trace a Rules Denial",
"scenario": "Firestore or Storage permission errors.",
"prompt": "Help me debug a Firebase rules denial. Use the requested operation, document path, auth claims, and write data to find the mismatch."
},
{
"title": "Build a Full Debug Plan",
"scenario": "Advanced issue across functions, auth, rules, and deployment.",
"prompt": "Create a full Firebase debug plan for this failure. Separate likely causes, evidence to collect, tests to run, and fix verification steps."
}
],
"output_examples": [
{
"input": "My emulators fail to start because a port is already in use.",
"output": [
"Classify the issue as an emulator startup problem.",
"Identify which Firebase port is occupied and which process owns it.",
"Confirm the process before stopping it, then restart the emulator suite.",
"Record the port conflict and prevention step in the debugging notes."
]
},
{
"input": "A Firestore write returns a permission denied error in local development.",
"output": [
"Classify the issue as a rules violation.",
"Reproduce the write in the Rules Playground with the same auth context.",
"Compare the request data and document path with the rule condition.",
"Update the rule or request shape, then rerun the same simulation."
]
},
{
"input": "My function returns an internal error after deployment.",
"output": [
"Classify the issue as a function or deployment problem.",
"Collect the exact error, runtime logs, and recent configuration changes.",
"Add focused logging around function entry, auth context, inputs, and caught errors.",
"Run the build step locally before testing a redeploy."
]
}
],
"best_practices": [
"Start by classifying the failure before changing code or configuration.",
"Preserve emulator state before restart when data helps reproduce the issue.",
"Redact environment values and credentials before sharing diagnostic output."
],
"anti_patterns": [
"Restarting every service before capturing the original error and logs.",
"Sharing full environment files when only variable names are needed.",
"Treating Admin SDK behavior as proof that client security rules allow access."
],
"faq": [
{
"question": "Does this skill fix Firebase issues automatically?",
"answer": "No. It guides diagnosis, suggests checks, and helps verify fixes after you approve changes."
},
{
"question": "Can it help with Firestore permission denied errors?",
"answer": "Yes. It focuses on the operation, document path, auth context, request data, and rule evaluation trace."
},
{
"question": "Does it require the Firebase Emulator UI?",
"answer": "The workflow recommends it for local debugging, but logs and terminal output can still provide useful evidence."
},
{
"question": "Can I use it for production outages?",
"answer": "It is designed for development debugging. Production incidents need monitoring, rollback plans, and incident procedures."
},
{
"question": "Will it read my environment files?",
"answer": "It may ask for configuration evidence. You should share only needed variable names and redact secret values."
},
{
"question": "Does it support Cloud Functions debugging?",
"answer": "Yes. It suggests targeted logging, input checks, auth context review, and local build verification."
}
]
},
"file_structure": [
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 183
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |