{
  "markdown": "# p2claw skill\n\nThe agent skill for **[p2claw](https://p2claw.com)** — share apps\nyou've built locally as peer-to-peer URLs that anyone with the link\ncan open in a browser. Works with any\n[Agent Skills](https://agentskills.io)–compatible coding agent.\n\nWhen you load this skill into your agent and ask it to share an app,\nthe agent:\n\n1. Detects whether the `p2claw` binary is already on the machine.\n2. Installs it if not (via the bundled installer, no `sudo`, no\n   global package managers).\n3. Starts the daemon — either as a long-running launchd / systemd\n   user service, or as a foreground process for short-lived sharing.\n4. Registers the route (`name → http://127.0.0.1:<port>`).\n5. Hands you back the public URL and a QR code for your phone.\n\nThe agent does the work; this skill is the instruction set that tells\nit how. Source for the instructions is [`p2claw/SKILL.md`](./p2claw/SKILL.md).\n\n> [!NOTE]\n> p2claw assumes a Bash/POSIX shell and supports macOS + Linux.\n> Windows users should run their agent inside WSL — the bundled\n> installer detects Windows and refuses with a helpful pointer.\n\n---\n\n## Installing the skill\n\nPick the matching section for your agent. All routes leave you with\nthe same on-disk shape — a `p2claw/` skill directory the agent can\ndiscover.\n\n### Claude Code\n\nThe repo ships a [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json)\nmanifest, so the cleanest path is to register this repo as a\nmarketplace and install through it:\n\n```text\n/plugin marketplace add phact/p2claw-skill\n/plugin install p2claw@p2claw\n```\n\nAlternatively, drop the skill in by hand:\n\n```bash\ngit clone --depth 1 https://github.com/phact/p2claw-skill /tmp/p2claw-skill\ncp -r /tmp/p2claw-skill/p2claw ~/.claude/skills/p2claw\n```\n\nAfter install, restart Claude Code and run `/skills` to confirm\n`p2claw` appears in the list. (Project-scoped install is the same\nflow into `.claude/skills/p2claw/` instead of `~/.claude/skills/`.)\n\n### Claude Desktop\n\nOpen the **Customize** panel in the left sidebar → **Skills** → click\nthe **+** next to *Personal plugins* → paste:\n\n```\nphact/p2claw-skill\n```\n\nRestart the app once installation finishes. The skill becomes\navailable as soon as you start a new conversation.\n\n### GitHub CLI (Copilot / `gh skill`)\n\nIf you have `gh` v2.90.0 or newer, the GitHub CLI ships a `skill`\nsubcommand that handles install for any agent it recognises:\n\n```bash\ngh skill install phact/p2claw-skill\n```\n\nOlder `gh`: `gh extension install` the upstream `gh-skill` extension\nfirst, or fall through to the manual git-clone path below.\n\n### OpenAI Codex CLI\n\nCodex scans `.agents/skills/` upward from the working directory, plus\nthe user-scope skill dir under `~/.config/codex/skills/`. Drop the\nskill into either:\n\n```bash\ngit clone --depth 1 https://github.com/phact/p2claw-skill /tmp/p2claw-skill\nmkdir -p ~/.config/codex/skills\ncp -r /tmp/p2claw-skill/p2claw ~/.config/codex/skills/p2claw\n```\n\nFor project-scoped use, replace `~/.config/codex/skills` with\n`<repo>/.agents/skills` inside the repo where you want it active.\n\n### GitHub Copilot in VS Code\n\nSkills follow the same SKILL.md format VS Code's Agent Skills feature\nexpects. Either install via `gh skill install phact/p2claw-skill`\n(see above), or use the VS Code skill UI: **Command Palette → Agent\nSkills: Add Skill** → paste the repo URL.\n\n### Gemini CLI\n\n```bash\ngit clone --depth 1 https://github.com/phact/p2claw-skill /tmp/p2claw-skill\ncp -r /tmp/p2claw-skill/p2claw ~/.gemini/skills/p2claw\n```\n\n(Gemini's path is `~/.gemini/skills/<name>/SKILL.md`. Restart Gemini\nCLI to pick up the new skill.)\n\n### OpenCode\n\nOpenCode also reads SKILL.md from a per-user skills directory:\n\n```bash\ngit clone --depth 1 https://github.com/phact/p2claw-skill /tmp/p2claw-skill\ncp -r /tmp/p2claw-skill/p2claw ~/.opencode/skills/p2claw\n```\n\n### Any other SKILL.md-compatible agent\n\nThe skill folder is `p2claw/` at the root of this repo. Every\nSKILL.md-aware agent (per the\n[Agent Skills spec](https://agentskills.io)) discovers skills from a\nconfigured directory containing `<name>/SKILL.md`. Drop `p2claw/`\ninto whatever path your agent uses and you're done.\n\n---\n\n## What gets installed when you use the skill\n\nThe skill **doesn't** install the p2claw binary at skill-install time.\nThe binary is installed lazily, the first time the agent uses the\nskill, via the bundled\n[`p2claw/scripts/install.sh`](./p2claw/scripts/install.sh) — a\nbyte-identical copy of the canonical installer at\n**[p2claw.com/install](https://p2claw.com/install)**. Drift between\nthe two is caught by\n[`.github/workflows/install-script-sync.yml`](.github/workflows/install-script-sync.yml),\nwhich opens a PR daily if they diverge.\n\nWhen the agent first runs the bundled installer, it:\n\n- Detects your OS + arch (macOS aarch64/x86_64, Linux x86_64/aarch64).\n- Downloads the matching binary from this repo's GitHub releases.\n- Verifies SHA-256 against the published `SHA256SUMS`.\n- Drops the binary at `~/.local/bin/p2claw` (no `sudo`).\n- Optionally registers it as a launchd / systemd `--user` service so\n  it survives reboot — only if you say yes when the agent asks.\n\nEverything user-managed: `~/.local/bin/p2claw`, the agent's\n`~/Library/Application Support/p2claw/` (macOS) or\n`~/.local/share/p2claw/` (Linux) state directory, and the optional\nlaunchd plist or systemd unit. Nothing system-wide.\n\n---\n\n## Uninstalling\n\n```bash\n~/.local/bin/p2claw service uninstall   # if you registered as a service\nrm ~/.local/bin/p2claw\nrm -rf \"~/Library/Application Support/p2claw\"   # macOS\n# or\nrm -rf ~/.local/share/p2claw                    # Linux\n```\n\nThen remove the skill from your agent's skill directory (the inverse\nof whichever install path you used above).\n\n---\n\n## Links\n\n- **Marketing site & docs:** <https://p2claw.com>\n- **Install script (canonical):** <https://p2claw.com/install>\n- **Skill source:** [`p2claw/SKILL.md`](./p2claw/SKILL.md)\n- **Releases (binary):** <https://github.com/phact/p2claw-skill/releases>\n- **Agent Skills spec:** <https://agentskills.io>\n",
  "bytes": 6036,
  "sha": "ded399d7daae17bbe6dde02e0914a837029e2d23b4716d72d5f7fff7c54d8fa2",
  "repo_slug": "phact/p2claw-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_phact_p2claw_skill_p2claw_111498f8/readme"
}