[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AHTVWWHFD00RF75XND5KD9":3,"skill-same:01M7AHTVWWHFD00RF75XND5KD9":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7AHTVWWHFD00RF75XND5KD9","mantle-upgrade-and-debug",null,"Diagnose Rasa Mantle failures and perform version upgrades. Use when an install\u002Flock\u002Fvalidate\u002Ftrain fails, when imports break after a version bump, when the agent ignores configuration, or when deciding which rasa-pro version to pin.","RasaHQ\u002Frasa-community-resources","RasaHQ","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F21214473?v=4","01M7ABXR532XTM0MWW7ZK48J12","Rasa","01M7AGG0E6HH8BMYVXAEY9SHWJ",44,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FRasaHQ\u002Frasa-community-resources\u002Fblob\u002Fmain\u002Fstarter-pack\u002F.claude\u002Fskills\u002Fmantle-upgrade-and-debug\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: mantle-upgrade-and-debug\ndescription: >\n  Diagnose Rasa Mantle failures and perform version upgrades. Use when an\n  install\u002Flock\u002Fvalidate\u002Ftrain fails, when imports break after a version bump,\n  when the agent ignores configuration, or when deciding which rasa-pro\n  version to pin.\n---\n\n# Upgrades and the failure→cause map\n\nMost Mantle failures report a symptom far from their cause. Look the message\nup here BEFORE debugging from first principles.\n\n## The failure→cause map\n\n| You see | Actual cause | Fix |\n| --- | --- | --- |\n| `ModuleNotFoundError: rasa.mantle` (or nothing importable) after pinning \"latest stable\" | The engine ships **only on `3.20.0.dev*`**; stable releases contain no engine package | Pin `rasa-pro==3.21.0.dev5`, `[tool.uv] prerelease = \"allow\"` |\n| `ModuleNotFoundError: rasa.calm_v2` after an upgrade | Package renamed `rasa.calm_v2` → `rasa.mantle` at 3.20.0.dev1, no alias | Update every engine import to `rasa.mantle` (route them through `lib\u002Fengine.py` so the next rename is a one-file change; see `docs\u002FMIGRATING.md`) |\n| `uv lock`: \"versions that are not supported by your dependencies (e.g., rasa-pro==3.21.0.dev5 only supports >=3.11, \u003C3.15)\" | `requires-python` floor below 3.11 — the error never says \"Python\" | Set `requires-python = \">=3.11,\u003C3.13\"` |\n| validate: `'provider': Extra inputs are not permitted` | Inline LLM config under `llm:` — removed in dev6 (`extra=\"forbid\"`) | `llm: {model_group: \u003Cid>}` + a `model_groups:` entry |\n| validate: `'model_group': Field required` | `llm:` block exists but names no group | Same as above |\n| validate rejects root `memory.yml` | `llm_settable: true` on project-level memory | Move the field to `skills\u002F\u003Cid>\u002Fmemory.yml`, or have a tool write it |\n| Agent ignores its rules\u002Fname\u002Freferences; no error anywhere | Prompt-tuning keys nested under `agent:` — parsed then silently discarded | Move them to the top level of agent.yml |\n| A skill branch never fires; no error | `if:` is indented — it's prose, not a condition | Move `if:` to column 0 of the skill body |\n| Literal `@memory.foo` or `session.x.y` text in replies | Token not substitutable: `@memory` needs exactly 3 parts; `session.*` never substitutes in prose | Use `@memory.\u003Cns>.\u003Centry>`, keep `session.*` in `if:`\u002Fconstraints |\n| Unexpanded `${SOME_KEY}` at train time | Key missing from environment and `.env` | Add to `.env` (and to `.env.example` + `required-secrets` so the next person finds it) |\n| `rasa init --engine \u003Cretired-name>` rejected | The pre-Mantle brand was retired; CLI accepts `{calm,mantle}` | Use `mantle`; purge the old name from docs — a stale brand in a runnable command is a broken command. (The name is not written out here so this file passes the very lint that catches it.) |\n\n## Upgrading the pin (e.g. dev6 → dev7)\n\n1. **Verify the target ships the engine before touching anything.** The\n   authority is the published wheel's module list, not release notes: check\n   that the wheel contains `rasa\u002Fmantle\u002F`. If you can't check, upgrade one\n   throwaway venv first and `python -c \"import rasa.mantle\"`.\n2. Bump `rasa-pro==\u003Ctarget>` in pyproject.toml, run\n   `uv lock` \u002F `uv sync --prerelease=allow`.\n3. **Sweep the prose too**: README \"Verified with:\", version mentions in\n   docs. Do it with care — a careless sweep rewrites upgrade-path lines into\n   `X → X` nonsense (this exact defect shipped in a real migration).\n4. Re-derive the top-level agent.yml key list from the installed engine —\n   dev releases add keys (`tool_timeout` arrived in dev6 unannounced). If\n   the engine's agent-spec payload reads a key your tooling doesn't know,\n   update the tooling's list.\n5. Run the full ladder and say which rungs you ran:\n   `lint_mantle.py` (offline consistency) → `rasa validate` → `rasa train`.\n   **A green offline lint does NOT test the engine contract** — only an\n   installed engine does. Never report \"upgrade verified\" off the lint alone.\n\n## Debugging discipline (earned the hard way)\n\nBefore asserting any diagnosis, name the one cheap command that would prove\nit wrong and run it — `git log --format=%cI`, a `grep` of the committed file,\none import in a venv. Most wrong turns in real Mantle debugging sessions came\nfrom acting on the first plausible reading of a symptom; every one would have\nbeen caught by a single command run before concluding.\n","# Upgrades and the failure→cause map\n\nMost Mantle failures report a symptom far from their cause. Look the message\nup here BEFORE debugging from first principles.\n\n## The failure→cause map\n\n| You see | Actual cause | Fix |\n| --- | --- | --- |\n| `ModuleNotFoundError: rasa.mantle` (or nothing importable) after pinning \"latest stable\" | The engine ships **only on `3.20.0.dev*`**; stable releases contain no engine package | Pin `rasa-pro==3.21.0.dev5`, `[tool.uv] prerelease = \"allow\"` |\n| `ModuleNotFoundError: rasa.calm_v2` after an upgrade | Package renamed `rasa.calm_v2` → `rasa.mantle` at 3.20.0.dev1, no alias | Update every engine import to `rasa.mantle` (route them through `lib\u002Fengine.py` so the next rename is a one-file change; see `docs\u002FMIGRATING.md`) |\n| `uv lock`: \"versions that are not supported by your dependencies (e.g., rasa-pro==3.21.0.dev5 only supports >=3.11, \u003C3.15)\" | `requires-python` floor below 3.11 — the error never says \"Python\" | Set `requires-python = \">=3.11,\u003C3.13\"` |\n| validate: `'provider': Extra inputs are not permitted` | Inline LLM config under `llm:` — removed in dev6 (`extra=\"forbid\"`) | `llm: {model_group: \u003Cid>}` + a `model_groups:` entry |\n| validate: `'model_group': Field required` | `llm:` block exists but names no group | Same as above |\n| validate rejects root `memory.yml` | `llm_settable: true` on project-level memory | Move the field to `skills\u002F\u003Cid>\u002Fmemory.yml`, or have a tool write it |\n| Agent ignores its rules\u002Fname\u002Freferences; no error anywhere | Prompt-tuning keys nested under `agent:` — parsed then silently discarded | Move them to the top level of agent.yml |\n| A skill branch never fires; no error | `if:` is indented — it's prose, not a condition | Move `if:` to column 0 of the skill body |\n| Literal `@memory.foo` or `session.x.y` text in replies | Token not substitutable: `@memory` needs exactly 3 parts; `session.*` never substitutes in prose | Use `@memory.\u003Cns>.\u003Centry>`, keep `session.*` in `if:`\u002Fconstraints |\n| Unexpanded `${SOME_KEY}` at train time | Key missing from environment and `.env` | Add to `.env` (and to `.env.example` + `required-secrets` so the next person finds it) |\n| `rasa init --engine \u003Cretired-name>` rejected | The pre-Mantle brand was retired; CLI accepts `{calm,mantle}` | Use `mantle`; purge the old name from docs — a stale brand in a runnable command is a broken command. (The name is not written out here so this file passes the very lint that catches it.) |\n\n## Upgrading the pin (e.g. dev6 → dev7)\n\n1. **Verify the target ships the engine before touching anything.** The\n   authority is the published wheel's module list, not release notes: check\n   that the wheel contains `rasa\u002Fmantle\u002F`. If you can't check, upgrade one\n   throwaway venv first and `python -c \"import rasa.mantle\"`.\n2. Bump `rasa-pro==\u003Ctarget>` in pyproject.toml, run\n   `uv lock` \u002F `uv sync --prerelease=allow`.\n3. **Sweep the prose too**: README \"Verified with:\", version mentions in\n   docs. Do it with care — a careless sweep rewrites upgrade-path lines into\n   `X → X` nonsense (this exact defect shipped in a real migration).\n4. Re-derive the top-level agent.yml key list from the installed engine —\n   dev releases add keys (`tool_timeout` arrived in dev6 unannounced). If\n   the engine's agent-spec payload reads a key your tooling doesn't know,\n   update the tooling's list.\n5. Run the full ladder and say which rungs you ran:\n   `lint_mantle.py` (offline consistency) → `rasa validate` → `rasa train`.\n   **A green offline lint does NOT test the engine contract** — only an\n   installed engine does. Never report \"upgrade verified\" off the lint alone.\n\n## Debugging discipline (earned the hard way)\n\nBefore asserting any diagnosis, name the one cheap command that would prove\nit wrong and run it — `git log --format=%cI`, a `grep` of the committed file,\none import in a venv. Most wrong turns in real Mantle debugging sessions came\nfrom acting on the first plausible reading of a symptom; every one would have\nbeen caught by a single command run before concluding.\n",{"name":5,"description":7},"main","082746ff3466e3beb59eba5fa274b6a90ac38419","starter-pack\u002F.claude\u002Fskills\u002Fmantle-upgrade-and-debug",19,"https:\u002F\u002Fgithub.com\u002FRasaHQ\u002Frasa-community-resources","https:\u002F\u002Frasa.community\u002F","https:\u002F\u002Fgithub.com\u002FRasaHQ","https:\u002F\u002Frasa.com","Rasa is a conversational AI framework for building reliable, scalable AI agents.","2026-11-14 12:02:45",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add RasaHQ\u002Frasa-community-resources --skill mantle-upgrade-and-debug",{"tool":40,"command":41},"bunx","bunx skills add RasaHQ\u002Frasa-community-resources --skill mantle-upgrade-and-debug",{"tool":43,"command":44},"pnpm","pnpm dlx skills add RasaHQ\u002Frasa-community-resources --skill mantle-upgrade-and-debug","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FRasaHQ\u002Frasa-community-resources\u002Fblob\u002Fmain\u002Fstarter-pack\u002F.claude\u002Fskills\u002Fmantle-upgrade-and-debug\u002FSKILL.md",true,[],[49,56,63,70,77,82],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7AJ24E15F9CMBGM3QZSKV6S","Build a travel desk","Handle developer requests to build or extend a Mantle travel agent using four approved travel tools.","https:\u002F\u002Fgithub.com\u002FRasaHQ\u002Frasa-community-resources\u002Fblob\u002Fmain\u002Fworkshops\u002Fsoftware-factories-masterclass\u002Fstudio\u002Fskills\u002Fbuild_agent\u002Fskill.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7AJ20RB027VHFWF2MAM79WC","Travel briefing","Answer questions about flight status, tonight’s departures, airport weather and currency conversion.","https:\u002F\u002Fgithub.com\u002FRasaHQ\u002Frasa-community-resources\u002Fblob\u002Fmain\u002Fworkshops\u002Fsoftware-factories-masterclass\u002Freference\u002Ffinished-agent\u002Fskills\u002Ftravel_briefing\u002Fskill.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7AJ1XQ9HR7H1ENZRX9YF5EJ","Review Dispute","Ask the outside reviewer about a card dispute, then block the card if the caller confirms. Activate when the caller reports a card transaction they did not make.","https:\u002F\u002Fgithub.com\u002FRasaHQ\u002Frasa-community-resources\u002Fblob\u002Fmain\u002Fworkshops\u002Fsoftware-factories-masterclass\u002Fopenai-mcp\u002Fproject\u002Fskills\u002Freview_dispute\u002Fskill.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7AJ1W0KTP19WYFACXY9WTRD","Block Card","Block a customer's lost or stolen card. Activate when the caller wants a card blocked.","https:\u002F\u002Fgithub.com\u002FRasaHQ\u002Frasa-community-resources\u002Fblob\u002Fmain\u002Fworkshops\u002Fsoftware-factories-masterclass\u002Ffactory\u002Fcandidates\u002Fblock-card-tamper\u002Fproduct\u002Fskills\u002Fblock_card\u002Fskill.md",[],[],{"skillNo":78,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7AJ1T5489X484B6V0KPR2AA","https:\u002F\u002Fgithub.com\u002FRasaHQ\u002Frasa-community-resources\u002Fblob\u002Fmain\u002Fworkshops\u002Fsoftware-factories-masterclass\u002Ffactory\u002Fcandidates\u002Fblock-card-hangs\u002Fproduct\u002Fskills\u002Fblock_card\u002Fskill.md",[],[],{"skillNo":83,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7AJ1RBPS99DXH3YY373ERWW","https:\u002F\u002Fgithub.com\u002FRasaHQ\u002Frasa-community-resources\u002Fblob\u002Fmain\u002Fworkshops\u002Fsoftware-factories-masterclass\u002Ffactory\u002Fcandidates\u002Fblock-card-good\u002Fproduct\u002Fskills\u002Fblock_card\u002Fskill.md",[],[]]