rasahq/rasa-community-resources/mantle-agent-config

Claude Code and agent skill by rasahq/rasa-community-resources

Trust tier 3
  • community
Source check pending

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-config

SKILL.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

yaml
agent:
id: my-agent # stable slug
language: en
persona: | # multi-line, the model's standing identity
You are <Name>, a concise assistant for <domain>.
Ask one question at a time and keep answers short.
# --- TOP LEVEL from here down ---
name: <Name>
description: <one line>
rules:
- "Be polite, clear, and brief."
- "Never state data that did not come from a tool."

Voice agents

Voice engines do NOT go in agent.yml. Set ASR and TTS on each channel that carries audio, in integrations.yml:

yaml
channels:
inspector:
enabled: true
asr:
name: deepgram # built-in name, or a dotted path
tts:
name: deepgram # e.g. voicerouter.RoutedTTS

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)

  1. Every prompt-tuning key at column 0? (grep -n '^\s\+rules:' agent.yml

must return nothing.)

  1. Persona says what the agent must NOT invent, and routes it to tools?
  2. Rules are short imperatives, not paragraphs?
  3. If voice: no voice: inside agent:; each audio channel in

integrations.yml names resolvable asr and tts engines?

  1. 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

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/rasahq/rasa-community-resources/mantle-agent-config/badge)](https://verified-skill.com/skills/rasahq/rasa-community-resources/mantle-agent-config)

Something wrong with this skill or its page? Tell us.