Develop and extend Koko — the Elixir/OTP agent living alongside joelclaw. Covers OTP patterns, Redis bridge protocol, shadow execution, and workload implementation.
74%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./skills/koko/SKILL.mdUse this skill when working on the Koko Elixir project — the BEAM co-resident agent alongside joelclaw.
Triggers: koko, elixir agent, beam, otp, shadow executor, koko workload, koko event, mix
~/Code/joelhooks/koko (github.com/joelhooks/koko)ssh joel@pandaAlways check relevant ADRs before implementing. Koko's architecture is ADR-driven.
| ADR | Title | Status | URL |
|---|---|---|---|
| 0114 | Elixir/BEAM/Jido Migration | proposed | joelclaw.com/adrs/0114-elixir-beam-jido-migration |
| 0115 | Koko Project Charter | proposed | joelclaw.com/adrs/0115-koko-project-charter |
| 0116 | Redis Bridge Protocol | proposed | joelclaw.com/adrs/0116-koko-redis-bridge-protocol |
| 0117 | First Workloads | proposed | joelclaw.com/adrs/0117-koko-first-workloads |
| 0118 | Shadow Executor | proposed | joelclaw.com/adrs/0118-koko-shadow-executor |
Before adding a new workload: Check ADR-0117 for the workload plan and ADR-0118 for shadow execution patterns.
Before changing Redis integration: Check ADR-0116 for the bridge protocol and phase boundaries.
Before any architectural change: Propose or update an ADR in ~/Vault/docs/decisions/.
joelclaw:koko:shadow:<function> in Redis or local files. Never to Typesense, Todoist, gateway, or any production state.# Run
cd ~/Code/joelhooks/koko
mix deps.get
mix run --no-halt
# Test
mix test
# Interactive
iex -S mix
Koko.events_seen()
# Format
mix format
# Remote (from another machine)
ssh joel@panda "cd ~/Code/joelhooks/koko && mix run --no-halt"one_for_one unless processes are coupled (then rest_for_one)handle_info — don't use if/else chainsLogger.info("[koko]") prefix for all log outputjoelclaw:gateway:events via PubSub ✅joelclaw:koko:events for claimed workLPUSH joelclaw:koko:events <payload>joelclaw:koko:resultsjoelclaw:koko:shadow:<function>joelhooks/joelclaw
f5b3a16
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.