create-webmcp-package
Installation
SKILL.md
Create A WebMCP Today Package
Produce a validated webmcp-package.json in the user's workspace and prove one exact harmless read request. Stop before registry publication.
Workflow
- Identify the target website URL and the single useful capability to expose first. Start with one read-only tool.
- Read the current package-format reference at https://webmcp.today/docs/package-format before authoring. The skill's pinned validator is authoritative for whether the resulting package is valid.
- Read
references/api-research.mdbefore researching an undocumented API, using browser network inspection, handling login/CSRF, or replaying a live request. - Prefer an official HTTP API. Otherwise observe the site's own frontend requests and document the evidence. Do not substitute DOM selectors, page scripts, or arbitrary browser automation for an API.
- Read
assets/minimal-readonly-package.jsonwhen starting a new package or when the required top-level shape is unclear. Adapt it; do not copy its example domain unchanged. - Create
webmcp-package.jsonin the user's current workspace, not in this skill directory. - Find the directory containing this
SKILL.mdand treat it asSKILL_DIR. IfSKILL_DIR/node_modules/@webmcp-today/schemais absent, runnpm ci --prefix "$SKILL_DIR" --ignore-scripts. Never assume the user is working in a clone of WebMCP Today. - Validate from any directory with
node "$SKILL_DIR/scripts/validate.mjs" "$PWD/webmcp-package.json". Fix every issue and rerun until it succeeds. - Derive the exact request from the validated endpoint and representative input, including every attached auth-source fetch. Replay only when the full request chain is harmless and reproducible by the executor. Show the method, fully resolved URL/query, credential mode, redirect behavior, and generated non-secret headers. Never execute a write for testing.
- Show the final JSON, exact redacted request, and concise live result. State any API assumptions or untested authenticated behavior.
- Stop. Do not submit, publish, accept registry terms, create an API key, or call a registry write endpoint. Publishing is a separate consent, legal, and write workflow.