Skip to main content

​
What this is

WaterrAI’s developer skill, packaged for OpenAI Codex. Codex reads an AGENTS.md at the project root for instructions and @-references prompt files for sub-tasks — so the skill ships as exactly that: an AGENTS.md plus a generate-understanding prompt. Once installed, when you ask Codex to build something on Waterr it will:
  1. Run @prompts/generate-understanding.md to interview you and produce a written scope-of-work
  2. Wait for your sign-off
  3. Implement against the canonical API docs (it cites every endpoint URL it uses)

​
Install

Codex doesn’t read the SKILL.md registry that powers the Claude Code install — it uses AGENTS.md at the project root instead. So the install is a manual clone-and-copy from the public waterrai/skills repo. From the root of the project where you’ll run Codex:
That drops two things into your project: If you already have an AGENTS.md, append the contents rather than overwriting. The skill’s rules are scoped to “WaterrAI work” and play nicely with other project rules. To update later:

​
How it works

​
1. You describe what you want

​
2. Codex runs the scoping interview

At most three questions per round, across three rounds:
  • What & why — user-facing outcome, trigger, where results land
  • The meeting — persona reuse, goals, recording, language
  • Integration shape — sync vs async, webhooks vs polling, auth
Then it writes WATERR_BUILD_SCOPE.md and asks you to confirm before any code is written.

​
3. You approve, Codex builds

The rules in AGENTS.md take over. Codex fetches the relevant API reference pages, writes the integration code, and cites the docs URL next to every endpoint it calls.

​
What the skill knows

AGENTS.md links Codex to the full developer docs and tells it to fetch before guessing: It also encodes the common pitfalls — membership_id ≠ user ID, voice IDs must come from /voices, analyses are async, scenarios are workspace-scoped.

​
Skip the scoping

For one-off endpoint questions, just ask directly without @-referencing the prompt:
AGENTS.md allows skipping the scoping interview for single concrete endpoint asks.

​
Source

Everything is open and copy-pasteable: github.com/waterrai/skills. PRs welcome.