rasahq/rasa-community-resources/mantle-agent-config
Claude Code and agent skill by rasahq/rasa-community-resources
- community
Checking that the SKILL.md file is still in the repository.
Author or review agent.yml for a Rasa Mantle project. Use when editing agent identity, persona, rules, references, voice settings, or when an agent ignores its rules/guardrails despite them being "configured".
Install
npx vskill@latest install rasahq/rasa-community-resources/mantle-agent-configSKILL.md
The same SKILL.md was published earlier as rasahq/rasa-community-resources/mantle-agent-config.
agent.yml — the file with the silent failure mode
The trap this file is famous for
Prompt-tuning keys nested under agent: parse without error and are then silently discarded. The engine's spec builder reads them only from the top level of the file; unknown keys inside agent: are ignored. A real catalog of ~10 projects once carried 39 rules the engine never applied — no warning at train time, no error at load, found only by reading the built prompt. Two independent users discovered it separately.
Top-level keys (siblings of `agent:`), checked against the catalog pin; see COMPATIBILITY.json: name, description, rules, conversation, references, before_end, tool_timeout.
tool_timeout was added in 3.20.0.dev6 — new top-level keys appear on dev releases, so after an upgrade, re-check this list against the installed engine rather than trusting it from memory.
Correct shape
Voice agents
Voice engines do NOT go in agent.yml. Set ASR and TTS on each channel that carries audio, in integrations.yml:
Do not add a nested agent.voice block. Rasa Pro 3.21 parses it but never wires it to a channel, and 3.22 rejects it with mantle.validation.config.invalid_agent_section. Rasa Pro 3.22 adds a top-level voice: block, but its asr and tts are model group ids, not engine names, and 3.21 does not read it, so the channel is the one place that works on both.
Custom ASR/TTS engines are referenced by dotted import path exactly like any custom engine class — the class must be importable from the project root. Voice persona tip observed to work well: instruct short spoken replies ("one or two short spoken sentences") — long text answers are painful read aloud.
Review checklist (run through it every time)
- Every prompt-tuning key at column 0? (
grep -n '^\s\+rules:' agent.yml
must return nothing.)
- Persona says what the agent must NOT invent, and routes it to tools?
- Rules are short imperatives, not paragraphs?
- If voice: no
voice:insideagent:; each audio channel in
integrations.yml names resolvable asr and tts engines?
- Run
python3 scripts/lint_mantle.py --check agent-top-level-keys— it
derives the block's own indentation, so 4-space files don't slip past.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingstarter-pack/.claude/skills/mantle-agent-config/SKILL.md
Popularity
- Repository stars
- 41
- Repository forks
- 11
- 7-day trend score
- 24
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/rasahq/rasa-community-resources/mantle-agent-config)