claude-skills-runner
A phone app (installed from the browser to the home screen) with one button per Claude Code skill. Tap a button, type or dictate the details (e.g. with Wispr Flow), tap Create, and the server runs…
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/midasedge--claude-skills-runner)HTML
<a href="/listings/midasedge--claude-skills-runner"><img src="/api/listings/midasedge--claude-skills-runner/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
- **Node.js 20+**: https://nodejs.org - **Git**: https://git-scm.com - **Claude Code**, logged in: install it, run `claude` once, and sign in. The app uses that login, so no API key is needed. - **Tailscale**: https://tailscale.com/download/windows. Run the installer, then sign in from the tray icon. (On Windows Server there's no `winget`; use the installer.)
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 115 lines
- # Claude Skills Runner
- A phone app (installed from the browser to the home screen) with one button per Claude Code skill. Tap a button, type or dictate the details (e.g. with Wispr Flow), tap **Create**, and the server runs that skill with Claude Code.
- ```
- Phone ("Skills Runner") --HTTPS via Tailscale--> server.js (port 8787) --> claude -p --> skill --> TickTick, etc.
- ```
- - No npm dependencies: plain Node 20+.
- - Buttons come from `tasks` in `config.json`. Currently: **Create personal task** → `personal-log` (TickTick).
- - The skills themselves live in their own GitHub repo and are installed separately (step 3).
- ---
- ## Rebuilding on a new server
- ### 1. Install prerequisites
- - **Node.js 20+**: https://nodejs.org
- - **Git**: https://git-scm.com
- - **Claude Code**, logged in: install it, run `claude` once, and sign in. The app uses that login, so no API key is needed.
- - **Tailscale**: https://tailscale.com/download/windows. Run the installer, then sign in from the tray icon. (On Windows Server there's no `winget`; use the installer.)
- ### 2. Get the app
- ```powershell
- cd D:\Workspace
- git clone https://github.com/squashprogib/claude-skills-runner.git claude-skill-runner
- cd claude-skill-runner
- ```
- ### 3. Install the skills
- Copy each skill folder (the one containing `SKILL.md`) into `%USERPROFILE%\.claude\skills\`, e.g. `C:\Users\Administrator\.claude\skills\personal-log\SKILL.md`. Then do each skill's own one-time setup (for personal-log: run `set-token.ps1` to store the TickTick token).
- Check that the skill works in Claude Code before going further:
- ```powershell
- claude -p "Use the personal-log skill: TEST please delete, today"
- ```
- It may say the script needs approval. That's expected here: the app pre-approves it. Any other error needs fixing first.
- ### 4. Configure
- ```powershell
- copy config.example.json config.json
- node -e "console.log(require('crypto').randomBytes(24).toString('base64url'))"
- ```
- Paste the generated string into `config.json` as `token`. This is the phone's password; `config.json` is not stored in git.
- If your Windows user isn't `Administrator`, fix the `script` paths in `config.json`.
- ### 5. Start it, and start it automatically at logon
- ```powershell
- .\install-autostart.ps1
- Start-ScheduledTask 'Claude Skill Runner'
- ```
- The server runs hidden and writes to `logs\server.log`. Don't run it with `npm start` in a console window you might click in: Windows "Select" mode freezes any program writing to that window, and the phone then reports "failed to fetch".
- Check it's up: `curl.exe http://127.0.0.1:8787/` should return the page.
- ### 6. Make it reachable from the phone
- ```powershell
- tailscale serve --bg --https=8443 8787
- ```
- - **Port 8443, not 443:** IIS on this server already owns port 443, so Tailscale can't use it. (On a server without IIS, plain `tailscale serve --bg 8787` gives you the address without `:8443`.)
- - The first time, it prints a link to enable HTTPS for your tailnet. Open it, enable it, and run the command again.
- - It prints the address, e.g. `https://<machine>.<tailnet>.ts.net:8443/`. A new server gets a new machine name.
- ### 7. Set up the phone
- 1. Install the Tailscale app, sign in with the same account, and switch it on.
- 2. Open `https://<machine>.<tailnet>.ts.net:8443/?token=<your token>` once. The token is saved on the phone and removed from the address bar.
- 3. Add to Home Screen (Android: ⋮ → Add to Home screen / Install app; iPhone: Share → Add to Home Screen). It appears as **Skills Runner**.
- ---
- ## Configuration (`config.json`)
- | Key | Meaning |
- |---|---|
- | `port` | Local port (default 8787). |
- | `token` | Shared secret the phone sends with every request. |
- | `claudeCommand` | `claude.exe` (must be on PATH). |
- | `workingDir` | Folder Claude runs in (default: this folder). |
- | `timeZone` | Used to tell Claude today's date. |
- | `timeoutSeconds` | Max time per run. |
- | `allowedTools` | Extra tools every run may use without asking (default: `PowerShell(Get-Date *)`). |
- | `tasks` | One entry per button (below). |
- ### Adding a skill (a new button)
- Add an entry under `tasks`, then restart: `Stop-ScheduledTask 'Claude Skill Runner'; Start-ScheduledTask 'Claude Skill Runner'`. The phone shows the new button the next time the app opens.
- ```json
- "shopping": {
- "label": "Add to shopping list",
- "skill": "shopping-log",
- "script": "C:\\Users\\Administrator\\.claude\\skills\\shopping-log\\shopping-log.ps1",
- "hint": "What to buy, and from where.",
- "placeholder": "e.g. milk, bread, batteries",
- "color": "#5fb37c"
- }
- ```
- - `skill`: the skill's folder name in `%USERPROFILE%\.claude\skills\`.
- - `script`: only for skills that run a PowerShell script. Use the full path, with no spaces. It's the only command the run may execute without approval.
- - `hint`, `placeholder` and `color` are optional.
- - If a skill needs other tools (an MCP server, Bash, web access), add them to `allowedTools`, e.g. `"mcp__ticktick"`.
- **Why the `script` setting exists:** nobody can approve permission prompts in a headless run, so each run pre-approves only `Skill(<skill>)` and `PowerShell(<script> *)`. Claude Code can't pre-approve a call written as `& "$env:USERPROFILE\...ps1"`, the form the SKILL.md files use; it rejects it as a "dynamic expression". So the server tells Claude to call the script as a bare literal path, which can be approved.
- ---
- ## Behaviour and troubleshooting
- - Runs usually take 10–60 s. You can tap **Back** while one is running. If the phone loses connection (screen lock, app switch), it reconnects and shows the result when you return.
- - If a run fails, your text is kept so you can retry.
- - Duplicates: the app shows `DUPLICATE: ...`. To add it anyway, create it again with "add anyway" in the text.
- - Every run is logged to `logs\<id>.json` (input, result, errors). Server output goes to `logs\server.log` and `logs\server.err.log`.
- - The prompt sent to Claude is `buildPrompt()` in `server.js`.
- - **"Failed to fetch" / nothing loads:** check that Tailscale is on on the phone; that `curl.exe http://127.0.0.1:8787/` works on the server (if not, restart the scheduled task); and that `tailscale serve status` shows the 8443 proxy.
- - **Lost token:** generate a new one (step 4), restart, and open the `?token=` link on the phone again.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.