{
  "markdown": "# clawpage\n\nA coding-agent plugin for [Clawpage](https://clawpage.ai) — generative UI hosting that turns single-file HTML pages into public URLs. Use it from Claude Code, Codex, or Gemini CLI.\n\n> **v1.0.0**: skills are now flat and independently invocable (one router was previously the entry point; that pattern has been replaced). Each skill self-describes when to trigger.\n\n## What you can do\n\n- Convert long stock-market analysis text into a chart-driven dashboard\n- Build insight hubs, utility tools, and interactive mini apps\n- Update existing pages by `pageId` with new content / style / behavior\n- Add server-side state to a page: comments, counters, KV data, short links, blob storage\n- Track view counts per page / homepage / short link\n- Author and update reusable templates\n\n## Skills\n\nEach skill is independently invocable by name. Coding agents auto-pick the right one based on user intent; you can also reference them directly (e.g. `clawpage:create-page`).\n\n| Skill | Use when |\n|---|---|\n| `clawpage:init` | First-time setup on a machine — register an account + save token. Idempotent. |\n| `clawpage:create-page` | Brand-new page. Default: private + 3h TTL. |\n| `clawpage:update-page` | Republish an existing page (you have its `pageId` or local project). |\n| `clawpage:delete-page` | Permanently delete a page by `pageId`. Irreversible — confirms first. |\n| `clawpage:create-management-page` | Read-only dashboard listing all your pages. |\n| `clawpage:create-template` / `clawpage:update-template` | Author or evolve a reusable template. |\n| `clawpage:manage-data` | Per-user KV data tables (comments, counters, configs, lightweight CMS). |\n| `clawpage:manage-links` | Short links `clawpage.ai/s/<slug>` → `*.clawpage.ai`. |\n| `clawpage:manage-blobs` | Upload images / files to R2, get public `blob.clawpage.ai/<id>` URLs. |\n| `clawpage:view-stats` | Page-view counts and per-day series. |\n| `clawpage:use-sdk` | Embed the Browser SDK so a page can call clawpage APIs without exposing tokens. |\n\n## Slash commands\n\n- `/clawpage-init` — initialize on this machine\n- `/clawpage-publish` — convert current response into a hosted clawpage page\n- `/clawpage-stats` — show traffic for your pages\n\n## Install\n\nThe plugin shells out to [`@clawpage.ai/cli`](https://www.npmjs.com/package/@clawpage.ai/cli) (the runtime), so you only need this plugin loaded — `npx` fetches the cli on demand.\n\n### Claude Code\n\n```text\n/plugin marketplace add https://github.com/clawpage/clawpage-skill\n/plugin install clawpage\n```\n\nUpdates: `/plugin update clawpage`.\n\n### Codex\n\n```bash\nnpx codex-marketplace add clawpage/clawpage-skill --plugin --global\n```\n\nThe plugin manifest lives at `.codex-plugin/plugin.json`. `--global` registers it in your Codex user config; drop the flag for project-scoped install.\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/clawpage/clawpage-skill\n```\n\nThe repo ships `gemini-extension.json` at the root.\n\n## Supply-chain note\n\nThe plugin invokes `npx -y @clawpage.ai/cli@<latest>` by default. **npm package code from `@clawpage.ai/cli` will execute on your machine** the first time you trigger any skill. Three layers of trust:\n\n1. **Source**: cli source at [github.com/clawpage/clawpage-cli](https://github.com/clawpage/clawpage-cli), MIT licensed. Audit before first run if you want.\n2. **Provenance**: every npm release ≥ `0.3.0` ships [npm provenance](https://docs.npmjs.com/generating-provenance-statements) attestations linking the tarball to the GitHub commit it was built from. `npm view @clawpage.ai/cli@<version>` shows the link.\n3. **Pin a version**: in your local copy of any SKILL.md, replace `npx -y @clawpage.ai/cli` with `npx -y @clawpage.ai/cli@0.5.0` (or whichever you've audited). Updates become opt-in.\n\nIf you'd rather avoid `npx` entirely: `npm install -g @clawpage.ai/cli@0.5.0` once, then change SKILL.md commands from `npx -y @clawpage.ai/cli ...` to `clawpage ...`.\n\n## First-time auth\n\nTrigger the `init` skill once:\n\n```text\nInit clawpage.\n```\n\nThis runs `npx -y @clawpage.ai/cli init`, registers a fresh account, and writes your API token to `~/.clawpage/keys.local.json`. After that, every subsequent skill invocation works from any directory.\n\nTo set the token manually instead:\n\n```bash\nmkdir -p ~/.clawpage\ncat > ~/.clawpage/keys.local.json <<'EOF'\n{\n  \"clawpage\": {\n    \"token\": \"sk_xxx\",\n    \"apiHost\": \"https://api.clawpage.ai\"\n  }\n}\nEOF\n```\n\n## Example: long stock analysis → visual page\n\n```text\nBuild a clawpage dashboard from this market note. Requirements:\n1) extract 5 key conclusions\n2) include KPI cards and 7D/30D/90D trend switching\n3) mobile-first layout\n4) publish and return publicUrl, rootUrl, accessUrl, pageId, expiresAt\n```\n\nWorkflow:\n- skill picks `stock-analysis-terminal` template\n- transforms raw text into structured modules (summary, risks, observations)\n- `npx -y @clawpage.ai/cli scaffold stock-analysis-terminal <page-name>` → `~/.clawpage/pages/<page-name>/`\n- `npx -y @clawpage.ai/cli publish --page-dir <page-name> ...`\n- returns the URL set + expiry info\n\n## Template catalog\n\nShipped with `@clawpage.ai/cli`. List at runtime: `npx -y @clawpage.ai/cli scaffold --list`.\n\n- `general_template`\n- `stock-analysis-terminal`\n- `insight-collection-hub`\n- `utility-workbench`\n- `concept-animation-lab`\n- `mini-game-arcade`\n\n## Direct CLI usage\n\nDry-run a template bundle (no publish, no auth required):\n\n```bash\nnpx -y @clawpage.ai/cli scaffold general_template /tmp/preview\nnpx -y @clawpage.ai/cli publish --page-dir /tmp/preview --title \"Preview\" --dry-run\n```\n\nPublish a page project:\n\n```bash\nnpx -y @clawpage.ai/cli publish \\\n  --page-dir my-dashboard \\\n  --title \"My Page\" \\\n  --subtitle \"Optional\"\n```\n\nCommon flags: `--page-id <id>`, `--ttl-ms <n|null>`, `--pagecode <text|null>`, `--page-name <text>`, `--dry-run`.\n\n## Security\n\n- `~/.clawpage/keys.local.json` holds your `sk_*` owner token. Never commit it; never paste into a public Clawpage page (it would steal the whole account).\n- Project-scoped `./keys.local.json` (cwd) takes precedence over the global one — handy for per-project accounts.\n- The `init` skill is **idempotent**: calling it when already initialized is a no-op. Switching accounts requires `--force` and explicit user confirmation; pages owned by the previous account are not deleted but become unreachable from this machine.\n\n## License\n\nMIT-0 (MIT No Attribution). See `LICENSE`.\n",
  "bytes": 6424,
  "sha": "d635cc3b2226f5ac6f900e774b1a9e7eaf00f189f2b1e723352b5ed5c3a0f9a5",
  "repo_slug": "clawpage/clawpage-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_clawpage_clawpage_skill_clawpage_b5898b0e/readme"
}