Skip to content
Back to search

claude-skills-runner

SkillWorks with Claude CodeGitHub

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/midasedge--claude-skills-runner/badge.svg)](/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

i

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
  1. # Claude Skills Runner
  2. 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.
  3. ```
  4. Phone ("Skills Runner") --HTTPS via Tailscale--> server.js (port 8787) --> claude -p --> skill --> TickTick, etc.
  5. ```
  6. - No npm dependencies: plain Node 20+.
  7. - Buttons come from `tasks` in `config.json`. Currently: **Create personal task** → `personal-log` (TickTick).
  8. - The skills themselves live in their own GitHub repo and are installed separately (step 3).
  9. ---
  10. ## Rebuilding on a new server
  11. ### 1. Install prerequisites
  12. - **Node.js 20+**: https://nodejs.org
  13. - **Git**: https://git-scm.com
  14. - **Claude Code**, logged in: install it, run `claude` once, and sign in. The app uses that login, so no API key is needed.
  15. - **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.)
  16. ### 2. Get the app
  17. ```powershell
  18. cd D:\Workspace
  19. git clone https://github.com/squashprogib/claude-skills-runner.git claude-skill-runner
  20. cd claude-skill-runner
  21. ```
  22. ### 3. Install the skills
  23. 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).
  24. Check that the skill works in Claude Code before going further:
  25. ```powershell
  26. claude -p "Use the personal-log skill: TEST please delete, today"
  27. ```
  28. It may say the script needs approval. That's expected here: the app pre-approves it. Any other error needs fixing first.
  29. ### 4. Configure
  30. ```powershell
  31. copy config.example.json config.json
  32. node -e "console.log(require('crypto').randomBytes(24).toString('base64url'))"
  33. ```
  34. Paste the generated string into `config.json` as `token`. This is the phone's password; `config.json` is not stored in git.
  35. If your Windows user isn't `Administrator`, fix the `script` paths in `config.json`.
  36. ### 5. Start it, and start it automatically at logon
  37. ```powershell
  38. .\install-autostart.ps1
  39. Start-ScheduledTask 'Claude Skill Runner'
  40. ```
  41. 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".
  42. Check it's up: `curl.exe http://127.0.0.1:8787/` should return the page.
  43. ### 6. Make it reachable from the phone
  44. ```powershell
  45. tailscale serve --bg --https=8443 8787
  46. ```
  47. - **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`.)
  48. - The first time, it prints a link to enable HTTPS for your tailnet. Open it, enable it, and run the command again.
  49. - It prints the address, e.g. `https://<machine>.<tailnet>.ts.net:8443/`. A new server gets a new machine name.
  50. ### 7. Set up the phone
  51. 1. Install the Tailscale app, sign in with the same account, and switch it on.
  52. 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.
  53. 3. Add to Home Screen (Android: ⋮ → Add to Home screen / Install app; iPhone: Share → Add to Home Screen). It appears as **Skills Runner**.
  54. ---
  55. ## Configuration (`config.json`)
  56. | Key | Meaning |
  57. |---|---|
  58. | `port` | Local port (default 8787). |
  59. | `token` | Shared secret the phone sends with every request. |
  60. | `claudeCommand` | `claude.exe` (must be on PATH). |
  61. | `workingDir` | Folder Claude runs in (default: this folder). |
  62. | `timeZone` | Used to tell Claude today's date. |
  63. | `timeoutSeconds` | Max time per run. |
  64. | `allowedTools` | Extra tools every run may use without asking (default: `PowerShell(Get-Date *)`). |
  65. | `tasks` | One entry per button (below). |
  66. ### Adding a skill (a new button)
  67. 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.
  68. ```json
  69. "shopping": {
  70. "label": "Add to shopping list",
  71. "skill": "shopping-log",
  72. "script": "C:\\Users\\Administrator\\.claude\\skills\\shopping-log\\shopping-log.ps1",
  73. "hint": "What to buy, and from where.",
  74. "placeholder": "e.g. milk, bread, batteries",
  75. "color": "#5fb37c"
  76. }
  77. ```
  78. - `skill`: the skill's folder name in `%USERPROFILE%\.claude\skills\`.
  79. - `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.
  80. - `hint`, `placeholder` and `color` are optional.
  81. - If a skill needs other tools (an MCP server, Bash, web access), add them to `allowedTools`, e.g. `"mcp__ticktick"`.
  82. **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.
  83. ---
  84. ## Behaviour and troubleshooting
  85. - 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.
  86. - If a run fails, your text is kept so you can retry.
  87. - Duplicates: the app shows `DUPLICATE: ...`. To add it anyway, create it again with "add anyway" in the text.
  88. - Every run is logged to `logs\<id>.json` (input, result, errors). Server output goes to `logs\server.log` and `logs\server.err.log`.
  89. - The prompt sent to Claude is `buildPrompt()` in `server.js`.
  90. - **"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.
  91. - **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 in

Free to use. If it’s helped, pass it on.