Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 18 additions & 2 deletions Packs/kai-agents-skill/INSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,23 +56,29 @@ Copy from this pack's `src/` directory to your PAI installation:
|--------|-------------|
| `src/skills/Agents/SKILL.md` | `$PAI_DIR/skills/Agents/SKILL.md` |
| `src/skills/Agents/Data/Traits.yaml` | `$PAI_DIR/skills/Agents/Data/Traits.yaml` |
| `src/skills/Agents/Data/NamedAgents.yaml` | `$PAI_DIR/skills/Agents/Data/NamedAgents.yaml` |
| `src/skills/Agents/Tools/AgentFactory.ts` | `$PAI_DIR/skills/Agents/Tools/AgentFactory.ts` |
| `src/skills/Agents/Templates/DynamicAgent.hbs` | `$PAI_DIR/skills/Agents/Templates/DynamicAgent.hbs` |
| `src/skills/Agents/Templates/NamedAgent.hbs` | `$PAI_DIR/skills/Agents/Templates/NamedAgent.hbs` |
| `src/skills/Agents/Workflows/UseNamedAgent.md` | `$PAI_DIR/skills/Agents/Workflows/UseNamedAgent.md` |
| `src/skills/Agents/Workflows/CreateCustomAgent.md` | `$PAI_DIR/skills/Agents/Workflows/CreateCustomAgent.md` |
| `src/skills/Agents/Workflows/ListTraits.md` | `$PAI_DIR/skills/Agents/Workflows/ListTraits.md` |
| `src/skills/Agents/AgentPersonalities.md` | `$PAI_DIR/skills/Agents/AgentPersonalities.md` |
| `src/skills/Agents/Workflows/SpawnParallelAgents.md` | `$PAI_DIR/skills/Agents/Workflows/SpawnParallelAgents.md` |

```bash
PAI_DIR="${PAI_DIR:-$HOME/.config/pai}"
PACK_DIR="[PATH_TO_THIS_PACK]"

cp "$PACK_DIR/src/skills/Agents/SKILL.md" "$PAI_DIR/skills/Agents/"
cp "$PACK_DIR/src/skills/Agents/Data/Traits.yaml" "$PAI_DIR/skills/Agents/Data/"
cp "$PACK_DIR/src/skills/Agents/Data/NamedAgents.yaml" "$PAI_DIR/skills/Agents/Data/"
cp "$PACK_DIR/src/skills/Agents/Tools/AgentFactory.ts" "$PAI_DIR/skills/Agents/Tools/"
cp "$PACK_DIR/src/skills/Agents/Templates/DynamicAgent.hbs" "$PAI_DIR/skills/Agents/Templates/"
cp "$PACK_DIR/src/skills/Agents/Templates/NamedAgent.hbs" "$PAI_DIR/skills/Agents/Templates/"
cp "$PACK_DIR/src/skills/Agents/Workflows/UseNamedAgent.md" "$PAI_DIR/skills/Agents/Workflows/"
cp "$PACK_DIR/src/skills/Agents/Workflows/CreateCustomAgent.md" "$PAI_DIR/skills/Agents/Workflows/"
cp "$PACK_DIR/src/skills/Agents/Workflows/ListTraits.md" "$PAI_DIR/skills/Agents/Workflows/"
cp "$PACK_DIR/src/skills/Agents/AgentPersonalities.md" "$PAI_DIR/skills/Agents/"
cp "$PACK_DIR/src/skills/Agents/Workflows/SpawnParallelAgents.md" "$PAI_DIR/skills/Agents/Workflows/"
```

### Step 3: Install Dependencies
Expand Down Expand Up @@ -104,13 +110,23 @@ echo "Checking installation..."

[ -f "$PAI_DIR/skills/Agents/SKILL.md" ] && echo "[OK] SKILL.md" || echo "[MISSING] SKILL.md"
[ -f "$PAI_DIR/skills/Agents/Data/Traits.yaml" ] && echo "[OK] Traits.yaml" || echo "[MISSING] Traits.yaml"
[ -f "$PAI_DIR/skills/Agents/Data/NamedAgents.yaml" ] && echo "[OK] NamedAgents.yaml" || echo "[MISSING] NamedAgents.yaml"
[ -f "$PAI_DIR/skills/Agents/Tools/AgentFactory.ts" ] && echo "[OK] AgentFactory.ts" || echo "[MISSING] AgentFactory.ts"
[ -f "$PAI_DIR/skills/Agents/Templates/DynamicAgent.hbs" ] && echo "[OK] DynamicAgent.hbs" || echo "[MISSING] DynamicAgent.hbs"
[ -f "$PAI_DIR/skills/Agents/Templates/NamedAgent.hbs" ] && echo "[OK] NamedAgent.hbs" || echo "[MISSING] NamedAgent.hbs"
[ -f "$PAI_DIR/skills/Agents/Workflows/UseNamedAgent.md" ] && echo "[OK] UseNamedAgent.md" || echo "[MISSING] UseNamedAgent.md"
[ -f "$PAI_DIR/skills/Agents/Workflows/CreateCustomAgent.md" ] && echo "[OK] CreateCustomAgent.md" || echo "[MISSING] CreateCustomAgent.md"
[ -f "$PAI_DIR/skills/Agents/Workflows/ListTraits.md" ] && echo "[OK] ListTraits.md" || echo "[MISSING] ListTraits.md"
[ -f "$PAI_DIR/skills/Agents/Workflows/SpawnParallelAgents.md" ] && echo "[OK] SpawnParallelAgents.md" || echo "[MISSING] SpawnParallelAgents.md"

echo ""
echo "Testing AgentFactory..."
bun run "$PAI_DIR/skills/Agents/Tools/AgentFactory.ts" --list | head -20

echo ""
echo "Testing named agents..."
bun run "$PAI_DIR/skills/Agents/Tools/AgentFactory.ts" --list-named

echo ""
echo "Testing trait composition..."
bun run "$PAI_DIR/skills/Agents/Tools/AgentFactory.ts" \
Expand Down
62 changes: 50 additions & 12 deletions Packs/kai-agents-skill/README.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,34 @@
---
name: Kai Agents Skill
pack-id: danielmiessler-agents-skill-core-v1.1.1
version: 1.1.1
author: danielmiessler
description: Dynamic agent composition and orchestration system - create custom agents with unique personalities, voices, and trait combinations on-the-fly
pack-id: danielmiessler-agents-skill-core-v1.2.0
version: 1.2.0
author: [danielmiessler, sti0]
description: Dynamic agent composition and orchestration system - create custom agents with unique personalities, voices, and trait combinations on-the-fly, plus named agents (The Engineer, The Architect, The Intern) with persistent identities
type: skill
purpose-type: [productivity, automation, development]
platform: claude-code
dependencies: [danielmiessler-core-install-core-v1.0.0]
keywords: [agents, delegation, parallel, traits, personalities, voice, composition, dynamic, factory, custom, orchestration, subagents]
keywords: [agents, delegation, parallel, traits, personalities, voice, composition, dynamic, factory, custom, orchestration, subagents, named-agents, engineer, architect, intern]
---

# Kai Agents Skill

> Dynamic agent composition system - create specialized agents with unique personalities and voices, composed from traits on-the-fly
> Dynamic agent composition system - create specialized agents with unique personalities and voices, composed from traits on-the-fly, plus named agents with persistent identities

## What's Included

| Component | File | Purpose |
|-----------|------|---------|
| Agents skill | `src/skills/Agents/SKILL.md` | Routing and agent definitions |
| Agent factory | `src/skills/Agents/Tools/AgentFactory.ts` | Dynamic agent composition |
| Agent factory | `src/skills/Agents/Tools/AgentFactory.ts` | Dynamic + named agent composition |
| Trait definitions | `src/skills/Agents/Data/Traits.yaml` | Expertise, personality, approach traits |
| Agent template | `src/skills/Agents/Templates/DynamicAgent.hbs` | Prompt template for composed agents |
| Named agents | `src/skills/Agents/Data/NamedAgents.yaml` | Engineer, Architect, Intern definitions |
| Dynamic template | `src/skills/Agents/Templates/DynamicAgent.hbs` | Prompt template for composed agents |
| Named template | `src/skills/Agents/Templates/NamedAgent.hbs` | Prompt template for named agents |
| Use named agent | `src/skills/Agents/Workflows/UseNamedAgent.md` | Named agent workflow |
| Create agent | `src/skills/Agents/Workflows/CreateCustomAgent.md` | Custom agent workflow |
| List traits | `src/skills/Agents/Workflows/ListTraits.md` | Show available traits |
| Personalities | `src/skills/Agents/AgentPersonalities.md` | Named agent examples |
| Spawn parallel | `src/skills/Agents/Workflows/SpawnParallelAgents.md` | Parallel agent orchestration |

## The Problem

Expand Down Expand Up @@ -56,9 +59,27 @@ Two types of agents working together:
| **Named Agents** | Persistent identities with backstories | Recurring work, voice output, relationships |
| **Dynamic Agents** | Task-specific specialists composed from traits | One-off tasks, novel combinations, parallel work |

### Named Agents

Three persistent agent identities with backstories, communication styles, and model preferences:

| Agent | Key | Model | Use For |
|-------|-----|-------|---------|
| **The Engineer** | `engineer` | sonnet | Implementation, code quality, technical decisions |
| **The Architect** | `architect` | opus | Design review, spec compliance, strategic vision |
| **The Intern** | `intern` | haiku | Grunt work, simple tasks, quick wins |

**Role Mappings:**
| Role | Maps To |
|------|---------|
| `implementer`, `developer`, `coder` | The Engineer |
| `spec_reviewer`, `architecture`, `design` | The Architect |
| `code_quality_reviewer`, `quality`, `reviewer` | The Engineer |
| `grunt_work`, `simple_task`, `quick_task` | The Intern |

### Trait Composition System

Agents are composed by combining three trait categories:
Dynamic agents are composed by combining three trait categories:

```
AGENT = Expertise + Personality + Approach
Expand All @@ -79,11 +100,19 @@ Each trait combination maps to a distinct voice automatically.
## Example Usage

```bash
# Infer traits from task
# Named agents
bun run AgentFactory.ts --named engineer --task "Implement the auth feature"
bun run AgentFactory.ts --named architect --task "Review the system design"
bun run AgentFactory.ts --role implementer --task "Build the API endpoint"

# List named agents
bun run AgentFactory.ts --list-named

# Infer traits from task (dynamic agent)
bun run AgentFactory.ts --task "Review this security architecture"
# Result: security + skeptical + thorough agent with appropriate voice

# Specify explicitly
# Specify explicitly (dynamic agent)
bun run AgentFactory.ts --traits "legal,meticulous,systematic"
# Result: Legal expert with careful systematic approach

Expand All @@ -93,6 +122,15 @@ bun run AgentFactory.ts --list

## Changelog

### 1.2.0 - 2026-01-07
- **NEW**: Named agents (The Engineer, The Architect, The Intern)
- **NEW**: `UseNamedAgent.md` workflow for spawning named agents
- **NEW**: `--named` parameter for persistent agent identities
- **NEW**: `--role` parameter for role-to-agent mapping
- **NEW**: `--list-named` to show available named agents
- **NEW**: `NamedAgents.yaml` for agent definitions
- **NEW**: `NamedAgent.hbs` template for named agent prompts

### 1.1.1 - 2026-01-03
- Added missing `SpawnParallelAgents.md` workflow (was referenced but didn't exist)
- Fixed workflow validation
Expand Down
125 changes: 0 additions & 125 deletions Packs/kai-agents-skill/src/skills/Agents/AgentPersonalities.md

This file was deleted.

Loading
Loading