From elixir-phoenix
Researches Elixir/Phoenix topics or evaluates Hex libraries by searching HexDocs, ElixirForum, and GitHub. Use for learning patterns, comparing approaches, or library assessments.
npx claudepluginhub oliver-kriska/claude-elixir-phoenix --plugin elixir-phoenixThis skill uses the workspace's default tool permissions.
Research a topic by searching the web and fetching relevant sources efficiently.
Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.
Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.
Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.
Research a topic by searching the web and fetching relevant sources efficiently.
/phx:research Oban unique jobs best practices
/phx:research LiveView file upload with progress
/phx:research --library permit
$ARGUMENTS = Research topic/question. Add --library for
structured library evaluation (uses ${CLAUDE_SKILL_DIR}/references/library-evaluation.md
template).
If $ARGUMENTS contains --library or the topic is clearly
about evaluating a Hex dependency (e.g., "should we use permit",
"evaluate sagents", "compare oban vs exq"):
${CLAUDE_SKILL_DIR}/references/library-evaluation.md for the template.claude/research/{lib}-evaluation.mdCache check: Check if .claude/research/{topic-slug}.md already
exists. If recent (<24 hours): present existing summary, ask
"Refresh or use existing?"
Tidewave shortcut: If the topic is about an existing dependency
(library already in mix.exs), prefer Tidewave over web search:
mcp__tidewave__get_docs(module: "LibraryModule")
This returns docs matching your exact mix.lock version — faster,
more accurate, zero web tokens. Only fall through to web search if
Tidewave is unavailable or the topic needs community discussion
(gotchas, real-world patterns, comparisons).
NEVER pass raw $ARGUMENTS into WebSearch. Decompose first:
$ARGUMENTS < 30 words and focused → use as single query$ARGUMENTS > 30 words or multi-topic → extract 2-4 queriesEach query: max 10 words, targets ONE specific aspect.
Example:
Input: "detect files, export to md, feed database with embeddings,
use ReqLLM for OpenAI API..."
Queries:
1. "Elixir PDF text extraction library hex"
2. "Ecto pgvector embeddings setup"
3. "ReqLLM OpenAI embeddings Elixir"
Search ALL decomposed queries in a SINGLE response (parallel):
WebSearch(query: "{query1} site:elixirforum.com OR site:hexdocs.pm OR site:github.com")
WebSearch(query: "{query2} site:hexdocs.pm OR site:elixirforum.com")
Deduplicate URLs across results. Discard clearly irrelevant hits.
Group URLs by topic cluster. Spawn 1-3 web-researcher agents in parallel (one per topic cluster):
Agent(subagent_type: "web-researcher", prompt: """
Research focus: {specific aspect from decomposed query}
Fetch these URLs:
- {url1}
- {url2}
- {url3}
Extract: code examples, patterns, gotchas, version compatibility.
Return 500-800 word summary.
""", run_in_background: true)
Rules:
After ALL agents complete, synthesize summaries into ONE file. Target: ~5KB for topic research, ~3KB for library evaluations.
Create .claude/research/{topic-slug}.md:
# Research: {topic}
## Summary
{2-3 sentence answer combining all worker findings}
## Sources
### {Category}
- [{title}]({url}) - {key insight}
### Code Examples
```elixir
# From {source}: {what this demonstrates}
{code}
### 5. After Research — STOP
**STOP and present the research summary.** Do NOT auto-transition.
Use `AskUserQuestion` to let the user choose next action:
- "Plan a feature based on this research" → `/phx:plan`
- "Investigate a specific finding" → `/phx:investigate`
- "Research more on a subtopic" → continue research
- "Done" → end
**NEVER auto-invoke `/phx:plan` or any other skill after research.**