Agent skill

Tidewave Integration

by oliver-kriska in oliver-kriska/claude-elixir-phoenix

Tidewave MCP runtime tools — debugging, smoke testing, live state inspection, SQL queries, hex docs.

MITAuto-check passedDatabases

Install Tidewave Integration

skills CLI

$ npx skills add oliver-kriska/claude-elixir-phoenix --skill tidewave-integration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install oliver-kriska/claude-elixir-phoenix tidewave-integration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/oliver-kriska/claude-elixir-phoenix.git skills-src && mkdir -p .claude/skills && cp -r skills-src/targets/pi/skills/tidewave-integration .claude/skills/tidewave-integration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "tidewave-integration" agent skill from https://github.com/oliver-kriska/claude-elixir-phoenix/tree/main/targets/pi/skills/tidewave-integration into .claude/skills/tidewave-integration/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tidewave-integration", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/oliver-kriska/claude-elixir-phoenix/tree/main/targets/pi/skills/tidewave-integration

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add oliver-kriska/claude-elixir-phoenix --skill tidewave-integration -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install oliver-kriska/claude-elixir-phoenix tidewave-integration --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/oliver-kriska/claude-elixir-phoenix.git skills-src && mkdir -p .agents/skills && cp -r skills-src/targets/pi/skills/tidewave-integration .agents/skills/tidewave-integration && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "tidewave-integration" agent skill from https://github.com/oliver-kriska/claude-elixir-phoenix/tree/main/targets/pi/skills/tidewave-integration into .agents/skills/tidewave-integration/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tidewave-integration", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add oliver-kriska/claude-elixir-phoenix --skill tidewave-integration -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install oliver-kriska/claude-elixir-phoenix tidewave-integration --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/oliver-kriska/claude-elixir-phoenix.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/targets/pi/skills/tidewave-integration .cursor/skills/tidewave-integration && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "tidewave-integration" agent skill from https://github.com/oliver-kriska/claude-elixir-phoenix/tree/main/targets/pi/skills/tidewave-integration into .cursor/skills/tidewave-integration/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tidewave-integration", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/oliver-kriska/claude-elixir-phoenix.git --path targets/pi/skills/tidewave-integration

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add oliver-kriska/claude-elixir-phoenix --skill tidewave-integration -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install oliver-kriska/claude-elixir-phoenix tidewave-integration --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/oliver-kriska/claude-elixir-phoenix.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/targets/pi/skills/tidewave-integration .gemini/skills/tidewave-integration && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "tidewave-integration" agent skill from https://github.com/oliver-kriska/claude-elixir-phoenix/tree/main/targets/pi/skills/tidewave-integration into .gemini/skills/tidewave-integration/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tidewave-integration", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install oliver-kriska/claude-elixir-phoenix tidewave-integration

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add oliver-kriska/claude-elixir-phoenix --skill tidewave-integration -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/oliver-kriska/claude-elixir-phoenix.git skills-src && mkdir -p .github/skills && cp -r skills-src/targets/pi/skills/tidewave-integration .github/skills/tidewave-integration && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "tidewave-integration" agent skill from https://github.com/oliver-kriska/claude-elixir-phoenix/tree/main/targets/pi/skills/tidewave-integration into .github/skills/tidewave-integration/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tidewave-integration", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add oliver-kriska/claude-elixir-phoenix --skill tidewave-integration -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install oliver-kriska/claude-elixir-phoenix tidewave-integration --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/oliver-kriska/claude-elixir-phoenix.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/targets/pi/skills/tidewave-integration .opencode/skills/tidewave-integration && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "tidewave-integration" agent skill from https://github.com/oliver-kriska/claude-elixir-phoenix/tree/main/targets/pi/skills/tidewave-integration into .opencode/skills/tidewave-integration/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tidewave-integration", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: tidewave-integration
GitHub stars: 565
Token cost: ~1.3k tokens
SKILL.md length: 466 words
Files: 4 (incl. references)
Skills in repo: 109
Repo updated: Oct 5, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Tidewave MCP runtime tools — debugging, smoke testing, live state inspection, SQL queries, hex docs.

Works in 5 steps: DEV ONLY — Never use Tidewave tools in… → PREFER TIDEWAVE OVER BASH —… → CHECK AVAILABILITY FIRST — Call Tidewave… → …
Evaluating code in a running Phoenix app
SKILL.md covers Iron Laws — Never Violate These, Quick Reference, Detection and Essential Patterns, plus 4 more sections
Calls curl and psql

What it does

Tidewave Integration is an agent skill from oliver-kriska/claude-elixir-phoenix. Tidewave MCP runtime tools — debugging, smoke testing, live state inspection, SQL queries, hex docs. Use when evaluating code in a running Phoenix app.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/proactive-patterns.md`, `references/tool-examples.md` and `references/validation-checklist.md`).

It sits in Databases, covering SQL, LLM observability and MCP servers. It works with SQL and Model Context Protocol. The repository describes itself as: Claude Code plugin for Elixir/Phoenix/LiveView — 26 specialist agents, Iron Laws enforcement, and Tidewave MCP integration. Plan features with parallel research agents, execute… The licence is MIT.

When your agent uses it

Evaluating code in a running Phoenix app
Tasks that involve SQL
Tasks that involve LLM observability

Example prompts

“/tidewave-integration”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

DEV ONLY — Never use Tidewave tools in production contexts. Avoid on shared dev servers with production data copies
PREFER TIDEWAVE OVER BASH — mcptidewaveget_docs > web_fetch, execute_sql_query > psql
CHECK AVAILABILITY FIRST — Call Tidewave only when matching mcptidewave* tools are present
SQL IS READ-HEAVY — Use execute_sql_query for SELECT, be careful with mutations
EXACT VERSIONS — get_docs returns docs for YOUR mix.lock versions, not latest

What it can do on your machine

Read from SKILL.md and the folder at commit 9767a82. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- curl
- psql
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tidewave Integration loads about 1.3k tokens when it runs, and up to ~4.1k if it reads all its reference files. Until then it costs about 43 tokens; SKILL.md has 466 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~43
When it runs · the whole SKILL.md, loaded when a task matches: ~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~4.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from oliver-kriska/claude-elixir-phoenix at commit 9767a82, republished under its MIT licence (© oliver-kriska). 466 words, ~1,261 tokens.

Download SKILL.mdSave it as .claude/skills/tidewave-integration/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.

name: tidewave-integration
description: Tidewave MCP runtime tools — debugging, smoke testing, live state inspection, SQL queries, hex docs. Use when evaluating code in a running Phoenix app.

Tidewave MCP Integration

Runtime intelligence for Phoenix apps via MCP. Prefer Tidewave tools over Bash when available.

Iron Laws — Never Violate These

DEV ONLY — Never use Tidewave tools in production contexts. Avoid on shared dev servers with production data copies
PREFER TIDEWAVE OVER BASH — mcp__tidewave__get_docs > web_fetch, execute_sql_query > psql
CHECK AVAILABILITY FIRST — Call Tidewave only when matching mcp__tidewave__* tools are present
SQL IS READ-HEAVY — Use execute_sql_query for SELECT, be careful with mutations
EXACT VERSIONS — get_docs returns docs for YOUR mix.lock versions, not latest

Quick Reference

Task	Tidewave Tool	Fallback
Get docs	`mcp__tidewave__get_docs Module.func/3`	`web_fetch hexdocs.pm/...`
Run code	`mcp__tidewave__project_eval`	`mix run -e "code"`
SQL query	`mcp__tidewave__execute_sql_query`	`psql $DATABASE_URL`
Find source	`mcp__tidewave__get_source_location`	`grep -rn "defmodule"`
Inspect DOM	`mcp__Tidewave-Web__browser_eval`	Manual browser inspection
List schemas	`mcp__tidewave__get_ecto_schemas`	Read `lib/*/schemas/`
Read logs	`mcp__tidewave__get_logs level: :error`	`tail -f log/dev.log`

Detection

bash

# Check endpoint
curl -s http://localhost:4000/tidewave/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"ping"}'

Or use /mcp in Claude Code to see connected servers.

Essential Patterns

Test Function Immediately

elixir

# mcp__tidewave__project_eval
MyApp.Accounts.create_user(%{email: "test@example.com"})

Verify Migration

sql

-- mcp__tidewave__execute_sql_query
SELECT column_name, data_type FROM information_schema.columns
WHERE table_name = 'users';

Debug LiveView (with PID from browser)

elixir

# mcp__tidewave__project_eval
pid = pid("0.1234.0")
:sys.get_state(pid) |> Map.get(:socket) |> Map.get(:assigns) |> Map.keys()

Setup Requirements

elixir

# mix.exs
{:tidewave, "~> 0.6", only: :dev}

# endpoint.ex (in dev block)
plug Tidewave

# config/dev.exs (for LiveView source mapping)
config :phoenix_live_view,
  debug_heex_annotations: true,
  debug_attributes: true

The dependency and endpoint plug expose Tidewave's streamable HTTP server; they do not register it with an MCP client. Configure the current runtime separately with http://localhost:<port>/tidewave/mcp, then verify that Tidewave tools are available before relying on this skill.

Reliability Guards

Worktree/port check (FIRST, in multi-worktree setups): multiple worktrees = multiple dev servers on different ports. Before trusting any Tidewave result, confirm the endpoint belongs to THIS checkout: grep config/dev.exs for the configured port, and verify with project_eval File.cwd!() — if it returns a different worktree path, you're debugging the wrong server.

Schema introspection BEFORE SQL: never guess column names. Run get_ecto_schemas (or query information_schema.columns) before writing SQL against a table you haven't already introspected this session. A guessed-column error costs more than the introspection.

Show full SKILL.md (182 more words)Show less

Output-size guard: runtime output is unbounded. Always cap it — LIMIT 20 in SQL, Enum.take(20) in evals, inspect(x, limit: 50, printable_limit: 500) for large structs. Re-query narrower rather than dumping wide.

browser_eval fallback: if mcp__Tidewave-Web__browser_eval is absent or errors, don't stall — inspect the same state server-side: LiveView assigns via :sys.get_state(pid) in project_eval, rendered HTML via Phoenix.LiveViewTest, or read the template source directly.

QA walkthrough pattern: after a feature completes, run a short checklist through project_eval/browser_eval: create the record, fetch it back, exercise the main event, check get_logs level: :error is clean. Report each step's pass/fail — not just "smoke test passed".

Proactive Runtime Checks

Query runtime state at workflow checkpoints without waiting to be asked:

After code edits: get_logs level: :error (catch runtime crashes)
After features complete: project_eval smoke test (behavioral check)
Before planning: get_ecto_schemas + routes eval (concrete context)
When investigating: Auto-capture errors before asking user
LiveView UI bugs: browser_eval to inspect DOM state before editing components

See references/proactive-patterns.md for full integration points.

References

For detailed patterns, see:

references/proactive-patterns.md - Push-like runtime patterns at workflow checkpoints
references/tool-examples.md - Complete tool usage examples
references/validation-checklist.md - Runtime validation patterns

Files

SKILL.md and 3 other files (references) in targets/pi/skills/tidewave-integration of oliver-kriska/claude-elixir-phoenix.

SKILL.md
references/proactive-patterns.md
references/tool-examples.md
references/validation-checklist.md

Open the folder on GitHubat commit 9767a82

Compare with similar skills

Tidewave Integration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tidewave Integration compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Tidewave Integration this skilloliver-kriska/claude-elixir-phoenix	565	—	~1.3k	Automated safety check: Pass	MIT	5 days ago
Semantic Analystsidequery/sidemantic	129	—	~982	Automated safety check: Pass	AGPL-3.0	3 days ago
Pytorch Clickhousepytorch/test-infra	113	—	~2.8k	Automated safety check: Pass	Custom licence	today
Tune Monitorsickn33/agentic-awesome-skills	47k	1 repos	~3.3k	Automated safety check: Pass	Apache-2.0	2 days ago
Sap Hana CLIsecondsky/sap-skills	462	—	~3.1k	Automated safety check: Notes	GPL-3.0	5 days ago
Nvidia Ontology QueryNVIDIA/skills	3.6k	—	~1.7k	Automated safety check: Pass	Apache-2.0	yesterday

Similar skills

Semantic Analyst
sidequery/sidemantic
Answer analytical, KPI, metric, trend, cohort, and business-performance questions through a Sidemantic semantic layer.
129 GitHub stars~982 tokensUpdated 3 days ago
DatabasesAuto-check passed
Pytorch Clickhouse
pytorch/test-infra
Load this FIRST whenever working with PyTorch CI data (any pytorch/ org repo), the torchci/HUD codebase, or the PyTorch HUD ClickHouse database.
113 GitHub stars~2.8k tokensUpdated today
DatabasesAuto-check passed
Tune Monitor
sickn33/agentic-awesome-skills
Analyze a Monte Carlo monitor and recommend config changes to reduce alert noise.
47k GitHub starsUsed in 1 repo~3.3k tokens
DatabasesAuto-check passed
Sap Hana CLI
secondsky/sap-skills
Assists with SAP HANA Developer CLI (hana-cli) for database development and administration.
462 GitHub stars~3.1k tokensUpdated 5 days ago
DatabasesAuto-check: notes
Nvidia Ontology Query
NVIDIA/skills
Official
Query Auto Ontology and validate generated SQL, rows, and answers.
3.6k GitHub stars~1.7k tokensUpdated yesterday
DatabasesAuto-check passed
Dune MCP Skill
holon-run/uxc
Use Dune MCP through UXC for blockchain table discovery, SQL query creation/execution, execution result retrieval, and visualization with help-first schema inspection, explicit auth binding, and…
116 GitHub stars~1.2k tokensUpdated 26 days ago
DatabasesAuto-check passed

Questions about Tidewave Integration

What does Tidewave Integration do?

Tidewave MCP runtime tools — debugging, smoke testing, live state inspection, SQL queries, hex docs. Tidewave Integration is an agent skill from oliver-kriska/claude-elixir-phoenix. Tidewave MCP runtime tools — debugging, smoke testing, live state inspection, SQL queries, hex docs.

When should I use Tidewave Integration?

Tidewave Integration fits situations like: evaluating code in a running Phoenix app; tasks that involve SQL; tasks that involve LLM observability.

How do I install Tidewave Integration in Claude Code?

Run `npx skills add oliver-kriska/claude-elixir-phoenix --skill tidewave-integration -a claude-code`. Or copy the skill folder (targets/pi/skills/tidewave-integration in oliver-kriska/claude-elixir-phoenix) into .claude/skills/tidewave-integration in your project. Claude Code loads it when a task matches its description.

How do I install Tidewave Integration in Codex?

Run `npx skills add oliver-kriska/claude-elixir-phoenix --skill tidewave-integration -a codex`. Or copy the skill folder (targets/pi/skills/tidewave-integration in oliver-kriska/claude-elixir-phoenix) into .agents/skills/tidewave-integration in your project. Codex loads it when a task matches its description.

Can I use Tidewave Integration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add oliver-kriska/claude-elixir-phoenix --skill tidewave-integration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tidewave-integration, .gemini/skills/tidewave-integration, .github/skills/tidewave-integration and .opencode/skills/tidewave-integration in your project.

What does Tidewave Integration need to run?

Going by SKILL.md and its folder, Tidewave Integration needs the command-line tools its instructions call (curl and psql).

Does Tidewave Integration access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Tidewave Integration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tidewave Integration use?

Tidewave Integration is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tidewave Integration use?

About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.8k tokens, read only when the agent opens those files.

What are the alternatives to Tidewave Integration?

Skills that share tags, products or a category with Tidewave Integration: Semantic Analyst (sidequery/sidemantic, 129 stars), Pytorch Clickhouse (pytorch/test-infra, 113 stars), Tune Monitor (sickn33/agentic-awesome-skills, 47k stars) and Sap Hana CLI (secondsky/sap-skills, 462 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tidewave Integration?

oliver-kriska (a GitHub user) maintains it in oliver-kriska/claude-elixir-phoenix, which has 565 GitHub stars. The repository holds 109 skills in this directory. The repository was last updated on October 5, 2026.

Source: oliver-kriska/claude-elixir-phoenix on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Tidewave Integration

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Tidewave MCP Integration

Iron Laws — Never Violate These

Quick Reference

Detection

Essential Patterns

Test Function Immediately

Verify Migration

Debug LiveView (with PID from browser)

Setup Requirements

Reliability Guards

Proactive Runtime Checks

References

Files

Compare with similar skills

Similar skills

More from oliver-kriska/claude-elixir-phoenix

Related

Questions about Tidewave Integration