Dowser

Dowser surfaces the right skill from a curated Claude Code skill library.

What it is

A Claude Code plugin that watches each prompt and suggests relevant skills from a local library. Matching combines:

• Fuse.js fuzzy search (typo-tolerant names and descriptions)
• TF-IDF term weighting
• Declarative rules in lib/skill-rules.json (keywords, intent patterns, priorities)
• Optional semantic embeddings via @xenova/transformers (on by default; set SKILL_ANALYZER_SEMANTIC=0 to disable)

When a skill fits, the UserPromptSubmit hook injects a short suggestion into context so you can load it with the Skill tool.

This repository also ships the skill library under skills/ (100+ domain and workflow skills).

Provenance

Dowser is original plugin work (hooks, hybrid search, garden tooling, evals). The skills/ tree is a curated library: many skills are first-party, and third-party content is redistributed under original licenses listed in NOTICE (including obra/superpowers-aligned workflows and Anthropic skill-creator materials). Treat skill count as library size, not LOC of novel engine code.

Requirements

• Bun 1.0+ (hooks and tests run on Bun)
• Claude Code with plugin support
• macOS or Linux paths that match Claude Code’s usual ~/.claude layout

Install (Claude Code plugin)

From a cold clone:

git clone https://github.com/dallascrilley/dowser.git
cd dowser
bun install

Point Claude Code at this plugin directory (local path install). Exact UI labels vary by Claude Code version; the contract is:

1. Plugin root is this repository (contains .claude-plugin/plugin.json and hooks/hooks.json).
2. CLAUDE_PLUGIN_ROOT resolves to that directory when hooks run.
3. Dependencies are installed so hooks/run-hook.sh can bun run the TypeScript hooks.

If you already manage plugins under ~/.claude/plugins/, you can clone or symlink this repo as ~/.claude/plugins/dowser (or keep a legacy dowser directory name; the search code still recognizes it).

mkdir -p ~/.claude/plugins
ln -sfn "$(pwd)" ~/.claude/plugins/dowser

Restart Claude Code or start a new session. On SessionStart, Dowser tries to load optional personal PAI context if you keep a PAI/SKILL.md (or ~/.claude/skills/PAI/SKILL.md). Missing PAI context is a warning, not a failure: skill search still works.

Quickstart (local smoke)

bun install
bun run test
# full suite (slower cold start): bun run test:all

Exercise the analyzer without Claude Code:

echo '{"userMessage":"help me write a failing test first","session_id":"local"}' \
  | bun run hooks/prompt-submit/analyze-prompt-skills.ts

You should get JSON with an optional skill suggestion block for TDD or related skills.

Garden checks (skill frontmatter health):

bun run test:garden
# or full garden suite
./scripts/garden.sh skills