recipe-format-reference

Documents the recipe bundle format for authoring and validating LingTai recipes.

692|60|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Lingtai-AI/lingtai --skill recipe-format-reference
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: recipe-format-reference
Source: https://github.com/Lingtai-AI/lingtai/tree/main/tui/internal/preset/skills/lingtai-recipe/reference/recipe-format
Command: npx skills add https://github.com/Lingtai-AI/lingtai --skill recipe-format-reference

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Authoring a LingTai recipe bundle requires knowing the exact directory layout, the recipe.json manifest schema, locale fallback rules, and validator expectations; this reference consolidates all of that so bundles pass validation on the first attempt.

Core Features & Use Cases

  • Bundle Structure Specification: Defines the required .recipe/ dotfolder, the four optional behavioral layers (greet, comment, covenant, procedures), and the optional framework-agnostic library sibling folder.
  • Manifest and i18n Rules: Documents the recipe.json schema (id, name, description, version, library_name), the rule that recipe.json is never localized, and the two-level locale fallback for behavioral layers.
  • Validation and Publishing Workflow: Explains what validate_recipe.py checks, how to hand-author a minimal recipe, how to test it via /setup, and how to publish it as a shareable git repo.
  • Use Case: You want to ship a recipe that installs a custom greeting and a library of skills into a LingTai project; follow this reference to lay out the bundle, set library_name correctly, and confirm the validator exits 0 before sharing.

Quick Start

Read this reference to author a recipe bundle with a .recipe/recipe.json manifest and validate it with validate_recipe.py before publishing.

Frequently Asked Questions about recipe-format-reference

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a LingTai recipe bundle?

Create a directory containing .recipe/recipe.json with the required id, name, and description fields. Optionally add greet, comment, covenant, or procedures layers and a library folder of skills, then run validate_recipe.py to confirm the bundle is structurally valid.

What fields are required in recipe.json?

recipe.json requires id, name, and description. The version field is optional and defaults to 1.0.0, while library_name is optional and names the sibling library folder when the recipe ships skills.

Can recipe.json be localized into multiple languages?

No, recipe.json must exist as a single canonical file at .recipe/recipe.json. Locale variants are forbidden because they can silently drop load-bearing fields like library_name, and the validator errors on any <lang>/recipe.json it finds.

How does locale fallback work for greet and comment files?

Each behavioral layer first checks .recipe/<layer>/<lang>/<layer>.md and falls back to .recipe/<layer>/<layer>.md if no locale variant exists. Known locale codes are en, zh, and wen, and a single root file can serve all languages.

Why is my recipe library not loading after applying a recipe?

The library folder must match recipe.json's library_name exactly, and each skill must live in its own subdirectory with SKILL.md at that subdirectory root. A SKILL.md placed directly at the library root is ignored by the scanner and rejected by the validator.

How do I validate a recipe bundle before publishing?

Run validate_recipe.py with the bundle root as its argument. Exit code 0 means the bundle is structurally valid, warnings do not block shipping, and exit code 1 indicates errors that must be fixed before publishing.