--- name: plan2meal description: Manage recipes and grocery lists in Plan2Meal via chat (add recipe URLs, list/search/show/delete recipes, and create/manage grocery lists). Use when users explicitly want Plan2Meal recipe/grocery actions. Do not use for generic cooking advice, nutrition coaching, or non-Plan2Meal todo/shopping tools. Success = command executed with clear result text (IDs, counts, links/errors) and accurate data-routing disclosure. requiredEnv: - CONVEX_URL - AUTH_GITHUB_ID - AUTH_GITHUB_SECRET - GITHUB_CALLBACK_URL - CLAWDBOT_URL optionalEnv: - AUTH_GOOGLE_ID - AUTH_GOOGLE_SECRET - GOOGLE_CALLBACK_URL - AUTH_APPLE_ID - AUTH_APPLE_SECRET - APPLE_CALLBACK_URL - ALLOW_DEFAULT_BACKEND primaryEnv: CONVEX_URL ---

Plan2Meal Skill

A ClawdHub skill for managing recipes and grocery lists via Plan2Meal.

Data routing + security disclosure (mandatory)

• Shared backend/API target: https://gallant-bass-875.convex.cloud
• Auth and recipe/grocery API traffic goes to configured CONVEX_URL.
• Shared backend usage is blocked unless ALLOW_DEFAULT_BACKEND=true.
• Never claim local-only processing when backend calls are involved.

Use when / don't use when (routing guardrails)

Use when:

• User asks to add/list/search/show/delete Plan2Meal recipes.
• User asks to create/view/update Plan2Meal grocery lists.
• User asks to authenticate for Plan2Meal commands.

Do NOT use when:

• User asks for general meal ideas (no Plan2Meal action requested).
• User asks for health/nutrition analysis outside stored Plan2Meal data.
• User asks to manage Apple Reminders/Notes/other systems.

Setup

1. Install:

```bash clawdhub install plan2meal ```

1. Configure environment:

```bash cp .env.example .env ```

1. Environment variables:

- CONVEX_URL (required, recommended self-hosted backend) - ALLOW_DEFAULT_BACKEND=true (only if intentionally using shared backend) - OAuth provider creds: - GitHub (required): AUTH_GITHUB_ID, AUTH_GITHUB_SECRET, GITHUB_CALLBACK_URL - Google (optional): AUTH_GOOGLE_ID, AUTH_GOOGLE_SECRET, GOOGLE_CALLBACK_URL - Apple (optional): AUTH_APPLE_ID, AUTH_APPLE_SECRET, APPLE_CALLBACK_URL - CLAWDBOT_URL (required, bot callback host)

Commands

• plan2meal login
• plan2meal logout
• plan2meal add
• plan2meal list
• plan2meal search
• plan2meal show
• plan2meal delete
• plan2meal lists
• plan2meal list-show
• plan2meal list-create
• plan2meal list-add
• plan2meal help

Output templates

Use response formatting templates from references/output-templates.md.

Security checklist before replying

• If command failed due to auth/config, provide exact next step.
• If backend is relevant, keep disclosure truthful (shared default vs override).
• Never expose secrets/tokens in output.