excalidraw
Generate an Excalidraw whiteboard in Sean's hand-drawn video style (Excalifont, roughness 1, green signature, socials +…
@shenseanchenInstall SkillProductivity
Skill
/new-tool
Add a new tool to Waku the right way — schema, safe execution, deterministic eval, honest output. Use when adding or modifying agent tools or when the user asks for a new capability.
Claude Code
$ npx -y skills add ShenSeanChen/waku-agent --skill new-tool --agent claude-code
Codex
$ npx skills add ShenSeanChen/waku-agent --skill new-tool -a codex -y
Cursor
$ npx skills add ShenSeanChen/waku-agent --skill new-tool -a cursor -y
Gemini CLI
$ npx skills add ShenSeanChen/waku-agent --skill new-tool -a gemini-cli -y
GitHub Copilot
$ npx skills add ShenSeanChen/waku-agent --skill new-tool -a github-copilot -y
OpenCode
$ npx skills add ShenSeanChen/waku-agent --skill new-tool -a opencode -y
Windsurf
$ npx skills add ShenSeanChen/waku-agent --skill new-tool -a windsurf -y
SKILL.md
new-tool.SKILL.mdname: new-tool description: Add a new tool to Waku the right way — schema, safe execution, deterministic eval, honest output. Use when adding or modifying agent tools or when the user asks for a new capability.
Procedure
1. One file per tool in `waku/tools/`, exposing `make_tool(...) -> Tool`. Copy the shape of `waku/tools/calendar.py` (the reference implementation). 2. The tool function must be:
- **Idempotent** where repeat calls could occur (check-before-insert, like
create_event's title+start guard).
- **Honest in its return string**: say exactly where the artifact went
(file path, table) and how the user can see it. Never imply effects the tool doesn't have.
- **Local-first by default**: write to `.waku/` or state.db; real external
services go behind env-gated adapters. 3. Register it in `waku/tools/__init__.py:build_registry`. 4. Add deterministic eval coverage in `evals/deterministic/`:
- offline: scripted client fires the tool → assert the artifact (DB row/file)
- a dataset case in `evals/dataset.jsonl` for the live tier
5. If the tool needs usage guidance, add a rule to DEFAULT_SOUL (`waku/runtime/session.py`) or a skill in `skills/`. 6. Check scope first: the repo ships flagship-task tools only. New capabilities beyond scheduling/notes/messages should be discussed before building.
Ships withwaku-agent
Your own AI assistant. On your laptop. In code you can read in an afternoon. Meet Waku — a local-first personal assistant that shows the four pillars behind every serious agent: Harness · Loop · Memory · Eval/LLM-Ops. No frameworks hiding the good parts.
2.2k14 skills
Stars on GitHub
Momentum
- stars in total
- 2.2k
Other skills on waku-agent.
@shenseanchenInstall Skillpr-worktree
Create and tear down the throwaway git worktrees used to test community PRs for waku-agent, without leaking API keys or leaving…
@shenseanchenInstall Skillrelease
Cut a waku-agent release when main is ahead of the last tag. Check the gap, bump the version, tag, confirm PyPI, announce. Use…
@shenseanchenInstall Skillreview-pr
Walk Sean through an incoming waku-agent PR or issue and present it his way — four fixed sections: what this is, why it matters,…
@shenseanchenInstall Skillship
Commit and push the current work properly — lint, run the release gate, write a detailed commit message, push to GitHub. Use…
@shenseanchenInstall Skillpokedex
Look up any Pokemon's types, base stats, and abilities from the public PokeAPI. Use whenever the user mentions a specific Pokemon…
@shenseanchenInstall SkillMore skills from other plugins.
i-have-adhd
Shape output for a reader with ADHD: lead with the next action, number multi-step work, restate state across turns, suppress…
@ayghriInstall Skill
distilly
Set up the owner profile so a personal agent knows who it works for (first-run setup, \"get to know me\"), or distill colleague,…
@titanwingsInstall SkillQuestions about new-tool.
- Which coding agents can use new-tool?
- new-tool installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.