a6bbd969b6
- 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
92 lines
2.4 KiB
Markdown
92 lines
2.4 KiB
Markdown
---
|
|
name: kugetsu-chat
|
|
description: Kugetsu Chat Agent - REQUIRED skill for ALL non-casual Telegram messages. This skill MUST be loaded and used for task delegation.
|
|
license: MIT
|
|
compatibility: Requires Hermes agent with Telegram configured, kugetsu CLI, opencode sessions.
|
|
metadata:
|
|
author: shoko
|
|
version: "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:
|
|
|
|
```bash
|
|
~/.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 |