profile-management

Manage Hermes agent profiles including persona authoring, channel routing, and Slack bot creation.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill profile-management-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: profile-management
Source: https://github.com/tapway/shogun-os/tree/main/skills/hermes/profile-management
Command: npx skills add https://github.com/tapway/shogun-os --skill profile-management-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up AI agent personas across chat platforms involves scattered config edits, cryptic Slack manifest errors, and routing bugs that are hard to diagnose. This Skill consolidates the full Hermes profile lifecycle into one operational guide. ## Core Features & Use Cases - Persona Authoring: Write SOUL.md persona files with naming conventions, core principles, voice rules, and access-control patterns. - Channel Wiring: Route Telegram, Slack, and Discord chats to the right profile via channel_prompts, with safe line-surgery edits that preserve config.yaml comments. - Slack Bot Setup: Create custom Slack app manifests, validate for duplicate or reserved commands, wire tokens, and configure per-user access control. - Use Case: Wire an HR profile to a Telegram group by discovering the chat ID, adding a channel_prompt entry, restarting the gateway, and verifying the bot responds as the correct persona. ## Quick Start Use the profile-management skill to wire my hr-manager profile to a new Slack channel and create its bot manifest.

Frequently Asked Questions about profile-management

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

FAQPage Schema
How do I wire a Hermes profile to a Telegram group?

Get the chat ID via @getidsbot or gateway logs, then add a channel_prompts entry mapping that ID to a profile-loading prompt. Restart the gateway afterward, since channel prompt changes only take effect after a restart.

How do I create a Slack bot for a specific agent profile?

Write a custom manifest JSON from scratch with only the slash commands the bot needs, validate it locally for duplicates, then have the user create the app at api.slack.com. Wire the xoxb and xapp tokens into the profile's .env file and start the gateway.

Why does my Telegram bot not respond to group messages?

The most common cause is Telegram bot privacy mode, which blocks group messages by default. Disable it via @BotFather or make the bot a group admin, then verify allowed_chats and allowed_users settings in the config.

Can I edit Hermes config.yaml with yaml.safe_load and yaml.dump?

No. yaml.dump reorganizes keys alphabetically and strips all comments, destroying the file's readability. Use Python line surgery to surgically insert channel_prompt entries while preserving structure and comments.

Why does my Slack bot use the wrong persona in DMs?

DMs fall back to SOUL.md when no channel prompt matches the DM channel ID. Discover the DM channel ID from gateway logs and add it to channel_prompts, or update SOUL.md to match the intended persona.

Which Slack slash command names are reserved?

Slack reserves built-in commands like /help, /leave, /away, /me, /msg, /whoami, /shrug, and /dnd. Attempting to register these in a manifest causes an 'invalid name' error, so choose alternative command names.