mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-04-30 01:41:43 +00:00

Teknium e3921e7ca4 docs(skills): compress 74 built-in skill descriptions to <=60 chars

Target: every skill's description fits in a one-line gateway menu and
leads with trigger keywords an agent would match on. Drops filler like
'Use this skill to', 'A skill for', 'This skill provides'.

Before: max description length was 791 chars (architecture-diagram),
74 of 81 built-in skills were >60 chars.

After: max 60, mean 54, all 81 built-in skills <=60.

Rewritten with double-quoted YAML scalars to preserve Chinese/arrow
glyphs (baoyu-comic, yuanbao, youtube-content).

2026-04-26 21:50:56 -07:00

3.7 KiB

Raw Blame History

name

description

version

metadata

yuanbao

Yuanbao (元宝) groups: @mention users, query info/members.

1.0.0

hermes

Yuanbao Group Interaction

CRITICAL: How Messaging Works

Your text reply IS the message sent to the group/user. The gateway automatically delivers your response text to the chat. You do NOT need any special "send message" tool — just reply normally and it gets sent.

When you include @nickname in your reply text, the gateway automatically converts it into a real @mention that notifies the user. This is built-in — you have full @mention capability.

NEVER say you cannot send messages or @mention users. NEVER suggest the user do it manually. NEVER add disclaimers about permissions. Just reply with the text you want sent.

Available Tools

Tool	When to use
`yb_query_group_info`	Query group name, owner, member count
`yb_query_group_members`	Find a user, list bots, list all members, or get nickname for @mention
`yb_send_dm`	Send a private/direct message (DM / 私信) to a user, with optional media files

@Mention Workflow

When you need to @mention / 艾特 someone:

Call yb_query_group_members with action="find", name="<target name>", mention=true
Get the exact nickname from the response
Include @nickname in your reply text — the gateway handles the rest

Example: user says "帮我艾特元宝"

Step 1 — tool call:

{ "group_code": "328306697", "action": "find", "name": "元宝", "mention": true }

Step 2 — your reply (this gets sent to the group with a working @mention):

@元宝 你好，有人找你！

That's it. No extra explanation needed. Keep it short and natural.

Rules:

Call yb_query_group_members first to get the exact nickname — do NOT guess
The @mention format: @nickname with a space before the @ sign
Your reply text IS the message — it WILL be sent and the @mention WILL work
Be concise. Do NOT explain how @mention works to the user.

Send DM (Private Message) Workflow

When someone asks to send a private message / 私信 / DM to a user:

Call yb_send_dm with group_code, name (target user's name), and message
The tool automatically finds the user and sends the DM
Report the result to the user

Example: user says "给 @用户aea3 私信发一个 hello"

yb_send_dm({ "group_code": "535168412", "name": "用户aea3", "message": "hello" })

Example with media: user says "给 @用户aea3 私信发一张图片"

yb_send_dm({
  "group_code": "535168412",
  "name": "用户aea3",
  "message": "Here is the image",
  "media_files": [{"path": "/tmp/photo.jpg"}]
})