Tiktok To Mealie

Extract recipe information from TikTok links, reconstruct a clean recipe, localize it to the user's language when needed, and import it into Mealie. Use when...

Security Scan

The skill's behavior (it needs a Mealie URL and API token and may read local secret files) matches its purpose, but the registry metadata does not declare those required credentials or secret-file access — this mismatch is a notable incoherence you should resolve before installing.

Purpose & Capability

The name and description (convert TikTok recipes and import to Mealie) match the SKILL.md and reference docs. The actions described (resolve TikTok URL, extract text, reconstruct recipe, upload to Mealie, upload image) are consistent with the stated purpose.

Instruction Scope

The runtime instructions are focused on extraction, reconstruction, localization, and calling Mealie APIs. They instruct resolving final TikTok URLs, downloading cover images, and creating/fetching/uploading recipes in Mealie. The skill also instructs reading configuration from environment variables or local secret files (~/.openclaw/secrets); that is within the skill's needs but is sensitive and should have been declared explicitly.

Install Mechanism

Instruction-only skill with no install spec and no code files — nothing is written to disk by an installer. This is the lowest-risk install mechanism.

Credentials

The documentation and SKILL.md require a Mealie base URL and API token (recommended env vars MEALIE_BASE_URL and MEALIE_API_TOKEN or local secret files). However, the registry metadata lists no required environment variables or credentials. This mismatch is disproportionate/untracked: the skill needs secrets to function (and can read local secret file paths), but the platform metadata doesn't declare or surface that need.

Persistence & Privilege

always:false (normal). The skill may be invoked autonomously (disable-model-invocation:false) which is the platform default; combined with the missing-declaration of required credentials this increases the chance of unintended automated imports if the platform allows the skill to access secrets without explicit consent.

What to consider before installing

This skill appears to do what it says, but the registry metadata failed to declare the Mealie credentials and secret-file access it expects. Before installing or enabling it: 1) Confirm how your OpenClaw environment grants skills access to environment variables and local files (will it prompt you or allow silent reads of ~/.openclaw/secrets?). 2) Only provide MEALIE_BASE_URL and MEALIE_API_TOKEN if you trust the skill and the platform; prefer a dedicated API token with limited scope. 3) If you want stricter control, require explicit user confirmation before the skill performs imports (so it can't auto-create recipes). 4) Ask the skill publisher to update the registry metadata to list the required env vars (MEALIE_BASE_URL, MEALIE_API_TOKEN) so the platform can surface permissions correctly. 5) Run initial tests with a throwaway/dedicated Mealie instance or token to validate behavior before using real data.

Use this skill when the user wants to turn TikTok cooking content into a real recipe.

Read as needed:

• references/workflow.md for the full extraction/import flow
• references/mealie-api-notes.md for Mealie-side behavior
• references/localization.md for translation/localization rules
• references/failure-modes.md for when to stop instead of importing junk
• references/output-templates.md for minimal reply behavior
• references/configuration.md for Mealie URL/token configuration

Core behavior

• Treat TikTok recipe extraction as reconstruction, not perfect scraping.
• Prefer a clean, usable recipe over a literal but messy transcription.
• Prefer execution over commentary when the user clearly wants import.
• Keep user-facing output short.
• If quality is too weak, fail cleanly instead of polluting Mealie.

Trigger patterns

Use this skill when the user:

• sends a TikTok recipe link
• asks to import a TikTok recipe into Mealie
• asks to convert a short-form cooking video into a structured recipe
• wants recipe extraction from TikTok cooking content

If a message is only a TikTok cooking link and the surrounding context suggests recipe import, treat it as an execution request.

Default flow

1. Resolve the final TikTok URL.
2. Extract as much useful text as possible from description, metadata, and visible structured clues.
3. Reconstruct:
   • title
   • description
   • ingredients
   • steps
   • times if reasonably inferable
   • servings if reasonably inferable
   • category/tags if useful
4. Recover a cover image if available.
5. Localize the recipe to the user's language if needed.
6. Check import quality threshold.
7. If good enough, create the recipe in Mealie.
8. Upload image if available.
9. Verify the created recipe before returning the final link.

Quality rules

• Do not import vague junk just because a TikTok link exists.
• Normalize ingredients and steps into an actually cookable recipe.
• If some quantities are missing, use reasonable uncertainty wording instead of fake precision.
• Prefer a coherent recipe with a few explicit assumptions over a broken half-parse.
• If the user language is clear, localize the final recipe consistently.
• Do not keep title, ingredients, and steps in mixed languages unless the user wants that.

Import threshold

Import only if:

• the title is coherent
• the ingredient list is reasonably usable
• the instruction list is reasonably usable
• the result is more reconstruction than guesswork

If these are not true, stop and explain briefly.

Mealie behavior

Before import, make sure a Mealie base URL and API token are configured. See references/configuration.md.

• Prefer structured recipe creation endpoints when available.
• Add source URL when possible.
• Upload cover image when available.
• Verify final recipe state before replying.
• Return the final recipe link on success.
• Do not assume user-specific hostnames, domains, or secret paths.

Output behavior

Use the minimal templates in references/output-templates.md.

Default rule:

• success -> return the recipe link
• weak extraction -> return a short failure reason
• partial but salvageable extraction -> ask one short confirmation question only if necessary

Style

• practical
• concise
• execution-focused
• avoid overexplaining
• optimize for a recipe someone can actually cook