Files

shokollm a6bbd969b6 feat(phase3a): update SKILL.md and SOUL.md with stronger routing instructions

- SKILL.md: More explicit about MUST use this skill for delegation
- SOUL.md: Explicitly instruct to invoke /kugetsu-chat skill first
- Add more explicit delegation rules and error handling

2026-03-30 15:06:04 +00:00

2.4 KiB

Raw Blame History

name, description, license, compatibility, metadata

name

description

license

compatibility

metadata

kugetsu-chat

Kugetsu Chat Agent - REQUIRED skill for ALL non-casual Telegram messages. This skill MUST be loaded and used for task delegation.

MIT

Requires Hermes agent with Telegram configured, kugetsu CLI, opencode sessions.

author	version
shoko	2.0

kugetsu-chat - REQUIRED SKILL FOR KUGETSU ROUTING

THIS SKILL MUST BE USED for any message that is not casual conversation.

CRITICAL: When to Use This Skill

YOU MUST LOAD AND USE THIS SKILL when:

Any message containing "issue", "fix", "create", "test", "implement"
Any message containing issue numbers like "#5", "#14", "#123"
Any message that looks like a task request or status query
Any message containing "pm", "status", "progress", "work on"

DO NOT USE THIS SKILL for:

"hi", "hello", "hey"
"thanks", "thank you"
"how are you", "what's up"
Casual greetings

Required Actions

When you MUST use this skill:

Step 1: Load This Skill

/kugetsu-chat

Step 2: Check if kugetsu is initialized

terminal(command="~/.local/bin/kugetsu-helper check-status", timeout=10)

Step 3: If initialized, DELEGATE immediately

terminal(command="~/.local/bin/kugetsu-helper delegate-to-pm '<entire user message>'", timeout=120)

Step 4: Relay the response to the user

Delegation Command

The ONLY command you should use for delegation:

~/.local/bin/kugetsu-helper delegate-to-pm '<user message>'

Example:

terminal(command="~/.local/bin/kugetsu-helper delegate-to-pm 'fix issue #5 in github.com/shoko/kugetsu'", timeout=120)

Error Handling

Status Output	Meaning	Action
`ok`	kugetsu is ready	Proceed with delegation
`kugetsu_not_initialized`	Not set up	Tell user to run `kugetsu init`
`pm_agent_missing`	PM not created	Tell user to run `kugetsu init`

Quick Reference

DELEGATION COMMAND:

terminal(command="~/.local/bin/kugetsu-helper delegate-to-pm '<message>'", timeout=120)

CHECK STATUS:

terminal(command="~/.local/bin/kugetsu-helper check-status", timeout=10)

Required Files

~/.local/bin/kugetsu-helper - The delegation helper script

Notes

ALWAYS use the full path ~/.local/bin/kugetsu-helper
ALWAYS use delegate-to-pm subcommand
ALWAYS wrap user message in single quotes inside the command
ALWAYS use timeout of at least 120 seconds for delegation

2.4 KiB Raw Blame History