install-poki — Claude Code skill: install and update Poki
The install-poki Claude Code skill installs Poki on an iPhone from a Mac and updates an existing app. It runs on an install or update request, or when the phone's own update gets stuck.
AGPL-3.0-only ★ 1,754 updated 2026-11-16
npx skills add JosssphZhou/poki --skill install-poki -a claude-codeWhat install-poki does
The skill runs Poki's checkout installer and relays its prompts during iPhone setup. For an update, it checks the app's existing signing identity before installing; a first-time setup needs Wi-Fi on the phone. The agent also reports the installer's checks.
Requirements include a Mac on macOS 14 or newer, Node.js 24 or newer, an iPhone on iOS 18 or newer, a USB data cable, an Apple Account, and a VPN app that routes 10.7.0.1 back to the iPhone. The checkout must contain bin/install-iphone.mjs. Without Node.js 24, use the alternate installation method; on iOS 18–26, the XCTest control path needs UI Automation and has not been tested on physical iPhones running those versions.
Transferring a model API key from the Mac keychain is optional and defaults to no. Poki uses its own model-provider account; the coding agent's subscription does not connect that account.
What it helps with
- install Poki on an iPhone from a Mac
- update an installed Poki app from a computer
- resume an update that stalls on the iPhone
- check installation results from the installer events
Example prompts for the agent
- Install Poki on my iPhone from this Mac.
- Update Poki on the connected iPhone.
- Poki's iPhone update is stuck; install it from the Mac.
How to install install-poki
1Skills CLI (Vercel)
npx skills add JosssphZhou/poki --skill install-poki -a claude-code2Manually: put the files in place
~/.claude/skills/install-poki/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/install-poki/
1Skills CLI (Vercel)
npx skills add JosssphZhou/poki --skill install-poki -a codex2Manually: put the files in place
.agents/skills/install-poki/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add JosssphZhou/poki --skill install-poki -a cursor2Manually: put the files in place
.cursor/skills/install-poki/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install JosssphZhou/poki skills/install-poki2Manually: put the files in place
.github/skills/install-poki/SKILL.md1Skills CLI (Vercel)
npx skills add JosssphZhou/poki --skill install-poki -a gemini-cli2Platform CLI
gemini skills install https://github.com/JosssphZhou/poki --path skills/install-pokiManually: put the files in place
.devin/skills/install-poki/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about install-poki
How do I install install-poki in Claude Code?
Run npx skills add JosssphZhou/poki --skill install-poki -a claude-code. The skill file is at ~/.claude/skills/install-poki/SKILL.md.
What does install-poki do?
It installs Poki on an iPhone from a Mac or updates an existing copy. Before an update, it checks the app's current signing identity.
What does install-poki need to run?
It needs a Mac on macOS 14 or newer, Node.js 24 or newer, an iPhone on iOS 18 or newer, a USB data cable, an Apple Account, Wi-Fi for the first install, and a VPN app routing 10.7.0.1 to the iPhone. The Poki checkout must include bin/install-iphone.mjs; a model API key can optionally be transferred from the Mac keychain.