dewee.sh content operator

The site's hand-built pages live in code (this repo). Custom pages (/p/<slug>) and blog posts (/blog/<slug>) live in D1 and are edited through the API. This skill covers only the second kind.

Before you start

1. You need an API key with the smallest scopes that fit: pages:read|write, posts:read|write, media:write, leads:read. Only the four super-admins can create keys at https://dewee.sh/admin/keys. Never print the key or paste it into a file in a repo.
2. Pick one interface:
   • CLI: npx -y dewee-web <command> with DEWEE_WEB_API_KEY in the environment. Add DEWEE_WEB_URL=https://staging.dewee.sh to try on staging first.
   • MCP: remote https://dewee.sh/mcp with Authorization: Bearer <key>, or the stdio bridge npx -y dewee-web mcp. tools/list shows only what your scopes allow.
3. Read https://dewee.sh/developers once. The API reference is /api/v1/openapi.json.

Workflow

1. Look first. pages list / posts list (MCP: list_pages, list_posts). Update an existing slug instead of creating a near-duplicate.
2. Blocks, not HTML. blocks list, then blocks schema <Type> (MCP: list_blocks, get_block_schema). Pages accept registered block types only; props are validated.
3. Write both languages. Every page or post gets an EN and a VI version that share a translation_key. The Vietnamese is written for Vietnamese readers, not machine-translated. Pricing in VI is Self-install and On-Premises only.
4. Save as a draft (drafts are not public; a super-admin can open the live preview in /admin). Publish, then check the public URL at 375 px and 1440 px in light and dark. Pass --version <n> on updates; a 409 conflict means someone saved first: re-read, merge, retry.
5. Media: media upload <file> (PNG, JPEG, WebP, GIF, AVIF, up to 10 MB) returns a cdn.dewee.sh URL. Every image needs real alt text.
6. Report the published URLs (EN and VI) and anything you could not verify.

Content rules

• Facts only. Numbers, features and release items come from the dewee repo, the changelog or /features. No invented customers, quotes, metrics or logos. If a claim is unverified, leave it out or ask.
• Say what is true by default. The way in starts shut (a token to connect, approval before a stranger can chat, private networks blocked). Agent capabilities start open and are narrowed by the operator. Prompt-injection checks warn by default. Do not write "closed by default" about the whole product.
• Voice: warm, plain, a little wry; short sentences; "we" for NextLevelBuilder, "you" for the reader. EN is the default locale.
• Keep titles under 60 characters and descriptions under 160; the site builds OG cards, .md twins and llms.txt entries from them.
• Never unpublish or delete someone else's page without being asked. Restoring a revision (list_revisions, restore_revision) is the safe undo.