← All skills
debugging-capacitor
85 / 100 · Low risk
Fine to try.
By Cap-go/capgo-skills (GitHub) · coding · 78 stars · scanned at commit e82217b
Diagnoses and fixes runtime bugs in Capacitor iOS/Android apps - white/blank screen on launch, startup crashes, `"X" plugin is not implemented on ios/android`, `net::ERR_CLEARTEXT_NOT_PERMITTED`, App Transport Security blocks, CORS on capacitor://localhost, permission denials, live reload not connecting, and Capacitor 8.5+ UIScene regressions (appUrlOpen, universal links, pause/resume silent because AppDelegate callbacks stopped). Covers Safari Web Inspector, chrome://inspect, Xcode/LLDB, Andro…
Works with any agent that supports SKILL.md skills.
What this skill can do
Downloads and installs other software
The author does not mention this.
Found in 29 places.
Show 17 more
- skills/debugging-capacitor/SKILL.md, line 49
| Native breakpoints | Xcode (`npx cap open ios`), LLDB | Android Studio debugger (`npx cap open android`) | - skills/debugging-capacitor/SKILL.md, line 50
| Run on target from CLI | `npx cap run ios --target <id>` | `npx cap run android --target <id>` | - skills/debugging-capacitor/SKILL.md, line 51
| List targets | `npx cap run ios --list` | `npx cap run android --list` | - skills/debugging-capacitor/SKILL.md, line 62
- Capacitor 9 (`@next`): `npx cap run ios --url http://192.168.1.68:5173`. The old `-l/--live-reload`, `--host`, `--port`, `--https` flags are removed. - skills/debugging-capacitor/SKILL.md, line 63
- Capacitor 8.5 (stable): `npx cap run ios -l --host 192.168.1.68 --port 5173` (add `--https` for an https dev server). - skills/debugging-capacitor/SKILL.md, line 72
| `"Foo" plugin is not implemented on ios` | Plugin not in native project, or JS injection blocked | `npm i <plugin>` -> `npx cap sync ios`. SPM: check `ios/App - skills/debugging-capacitor/SKILL.md, line 73
| `"Foo" plugin is not implemented on android` | Gradle not synced, or a service worker intercepts the page | `npx cap sync android`, then File > Sync Project w - skills/debugging-capacitor/SKILL.md, line 75
| `⚡️ ERROR: Unable to load .../index.html` / white screen | `webDir` wrong or never copied | Build web, verify `webDir` matches output folder, `npx cap copy`. - skills/debugging-capacitor/SKILL.md, line 82
| `No such module 'Capacitor'` (Xcode) | Opened `.xcodeproj` with CocoaPods, or SPM packages not resolved | Pods: open `App.xcworkspace`, `npx cap sync ios`. SP - skills/debugging-capacitor/SKILL.md, line 92
1. `npx cap doctor` shows matching `@capacitor/core`, `cli`, `ios`, `android` versions. - skills/debugging-capacitor/SKILL.md, line 93
2. `npm run build && npx cap sync` completes with no warnings about missing plugins. - skills/debugging-capacitor/references/common-failures.md, line 6
1. Native console: iOS `⚡️ ERROR: Unable to load .../public/index.html` or Android `Capacitor` errors -> web assets missing. Check `webDir` in `capacitor.confi - skills/debugging-capacitor/references/common-failures.md, line 10
5. Leftover `server.url` pointing at a dev machine that is off -> blank or "Webpage not available". Remove it and `npx cap copy`. - skills/debugging-capacitor/references/common-failures.md, line 16
- Installed but not synced: `npx cap sync` (sync = copy + update native deps). - skills/debugging-capacitor/references/common-failures.md, line 18
- iOS CocoaPods: plugin pod present in `ios/App/Podfile` (Capacitor 8 template), then `pod install` via `npx cap sync ios`. - skills/debugging-capacitor/references/common-failures.md, line 47
- After stopping live reload the app still loads the dev URL: `cap run` writes `server.url` into the copied native `capacitor.config.json` and reverts it on exi - skills/debugging-capacitor/references/common-failures.md, line 51
`npx cap doctor` must show identical major/minor for `@capacitor/core`, `@capacitor/cli`, `@capacitor/ios`, `@capacitor/android`. Capacitor 8.5 is current stabl
and 9 more places
Other copies in this repository
Cap-go/capgo-skills has 1 more folder with a skill named debugging-capacitor. This page shows the lowest-scoring copy.
Install
Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.
if [ -e ~/.agents/skills/'debugging-capacitor' ] || [ -L ~/.agents/skills/'debugging-capacitor' ]; then echo 'A skill folder named debugging-capacitor already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/Cap-go/capgo-skills' "$d" && git -C "$d" checkout --quiet 'e82217b8fa76e11a2b2fdb49c6a221df8359cb54' -- 'skills/debugging-capacitor' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills/debugging-capacitor' ~/.agents/skills/'debugging-capacitor' && rm -rf "$d"; fi
Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'debugging-capacitor' ~/.claude/skills/'debugging-capacitor' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.
Badge for your README
The badge for Cap-go/capgo-skills shows the score of its lowest-scoring skill.
[](https://zalavijaysinh.github.io/skilltrust/repos/Cap-go/capgo-skills/)
Score history
| Date | Version | Score |
|---|
| 2026-11-12 | e82217b | 85 |
| 2026-11-08 | e90bb56 | 100 |
| 2026-11-06 | e90bb56 | 85 |