ima-claude 2.18.0 → 2.25.0

package/plugins/ima-claude/skills/mcp-serena/SKILL.md

@@ -5,26 +5,22 @@ description: "Use Serena MCP for ALL code navigation and investigation — it sa
 
 # Serena MCP - Code Symbol Operations
 
-Use Serena for code symbol discovery and modification instead of reading entire files.
+Use Serena FIRST for all code investigation — before Read/Grep/Glob. Reading entire files wastes 40-70% token budget. Serena gives precise symbol-level access: structure without content, bodies only when needed, references without scanning every file.
 
-## Setup: Direct Access
+Tools available as `mcp__serena__*` (direct access, not through gateway).
 
-Serena runs directly (not through Airis gateway). Tools are available as `mcp__serena__*`.
-
-## MCP Tools
+## Tools
 
 | Tool | Purpose |
 |------|---------|
-| `mcp__serena__jet_brains_find_symbol` | Find symbols by name path pattern |
-| `mcp__serena__jet_brains_find_referencing_symbols` | Find all references to a symbol |
-| `mcp__serena__rename_symbol` | Rename symbol across entire codebase |
-| `mcp__serena__jet_brains_get_symbols_overview` | Get top-level symbols in a file |
-| `mcp__serena__search_for_pattern` | Regex pattern search (better for Vue) |
-| `mcp__serena__list_dir` | List directory contents |
-
-## Workflow: Symbol Discovery
+| `jet_brains_find_symbol` | Find symbols by name path pattern |
+| `jet_brains_find_referencing_symbols` | Find all references to a symbol |
+| `rename_symbol` | Rename symbol across entire codebase |
+| `jet_brains_get_symbols_overview` | Get top-level symbols in a file |
+| `search_for_pattern` | Regex pattern search (preferred for Vue) |
+| `list_dir` | List directory contents |
 
-### Find a Symbol
+## Symbol Discovery
 
 ```
 mcp__serena__jet_brains_find_symbol
@@ -33,11 +29,9 @@ mcp__serena__jet_brains_find_symbol
   depth: 1
 ```
 
-- Use `depth: 1` to see methods/properties
-- Use `include_body: true` only when you need implementation details
-- Use `relative_path` to narrow search scope
-
-### Find All References
+- `depth: 1` — see methods/properties
+- `include_body: true` — only when implementation needed
+- `relative_path` — narrow search scope
 
 ```
 mcp__serena__jet_brains_find_referencing_symbols
@@ -46,19 +40,13 @@ mcp__serena__jet_brains_find_referencing_symbols
   include_info: true
 ```
 
-### Get File Overview
-
 ```
 mcp__serena__jet_brains_get_symbols_overview
   relative_path: "src/services/user.ts"
   depth: 1
 ```
 
-Better than reading entire file when you just need structure.
-
-## Workflow: Symbol Modification
-
-### Rename Symbol
+## Symbol Modification
 
 ```
 mcp__serena__rename_symbol
@@ -67,41 +55,29 @@ mcp__serena__rename_symbol
   new_name: "fetchUserData"
 ```
 
-Automatically updates all references across the codebase.
+Updates all references automatically.
 
-## Gitignore Handling (Important)
+## Gitignore Handling
 
-**Known Issue**: Serena has problems with complex `.gitignore` negation patterns (GitHub Issue #600).
-
-Example problem:
-```gitignore
-plugins/           # Ignored
-!plugins/custom/   # Re-included (but Serena may still ignore it)
-```
+Known issue: complex `.gitignore` negation patterns block Serena (GitHub #600). Example: `plugins/` ignored + `!plugins/custom/` re-included — Serena may still skip it.
 
-Serena's `is_ignored_path()` returns `True` early, bypassing negation logic.
+Workarounds:
 
-### Workarounds
-
-**For `list_dir`** - use `skip_ignored_files: false`:
 ```
+# list_dir — use skip_ignored_files: false
 mcp__serena__list_dir
   relative_path: "plugins"
   recursive: true
   skip_ignored_files: false
-```
 
-**For `search_for_pattern`** - target folder directly with `relative_path`:
-```
+# search_for_pattern — target folder directly
 mcp__serena__search_for_pattern
   substring_pattern: "functionName"
   relative_path: "plugins/custom"
   context_lines_before: 2
   context_lines_after: 2
-```
 
-**Alternative** - use explicit glob to include:
-```
+# Or use explicit glob
 mcp__serena__search_for_pattern
   substring_pattern: "functionName"
   paths_include_glob: "**/plugins/**"
@@ -109,9 +85,7 @@ mcp__serena__search_for_pattern
 
 ## Vue 3 / Quasar Projects
 
-**Important**: TypeScript LSP doesn't fully understand Vue 3 `<script setup>` syntax.
-
-For `.vue` files and `src/composables/`, prefer pattern search:
+TypeScript LSP doesn't fully understand Vue 3 `<script setup>`. For `.vue` files and `src/composables/`, use pattern search:
 
 ```
 mcp__serena__search_for_pattern
@@ -121,54 +95,54 @@ mcp__serena__search_for_pattern
   context_lines_after: 2
 ```
 
-**Decision Logic for Vue**:
 ```
-IF target is .vue file OR src/composables/:
-    → Use search_for_pattern (more reliable)
-ELSE IF pure .ts/.js files:
-    → Use LSP tools (find_symbol, find_referencing_symbols)
+IF .vue file OR src/composables/:
+    → search_for_pattern
+ELSE IF .ts/.js files:
+    → find_symbol, find_referencing_symbols
 ```
 
 ## Decision Logic
 
 ```
-IF need to find/understand code symbols:
-    → Use find_symbol, find_referencing_symbols
-ELSE IF need to rename/refactor symbol:
-    → Use rename_symbol (handles dependencies automatically)
-ELSE IF simple text pattern search:
-    → Use search_for_pattern
-ELSE IF searching in gitignore-negated folder:
-    → Use relative_path to target directly OR skip_ignored_files: false
-ELSE IF reading full file needed:
-    → Use native Read tool
+IF find/understand code symbols:
+    → find_symbol, find_referencing_symbols
+ELSE IF rename/refactor:
+    → rename_symbol
+ELSE IF text pattern search:
+    → search_for_pattern
+ELSE IF gitignore-negated folder:
+    → relative_path directly OR skip_ignored_files: false
+ELSE IF full file content needed:
+    → native Read tool
 ```
 
 ## Error Recovery
 
 | Error | Recovery |
 |-------|----------|
-| Symbol not found | Try broader name_path_pattern, check spelling |
+| Symbol not found | Broader name_path_pattern, check spelling |
 | Vue SFC issues | Switch to search_for_pattern |
-| Gitignore blocking folder | Use relative_path directly or skip_ignored_files: false |
+| Gitignore blocking | Use relative_path or skip_ignored_files: false |
 | Rename failed | Check if symbol is in external dependency |
 | Too many results | Add relative_path to narrow scope |
 
-## When NOT to Use
+## Fall Back to Read/Grep Only For
+
+- Non-code files: markdown, JSON, YAML, config (LSP doesn't index these)
+- Serena unavailable or returning errors
+- Full file content after overview identified what to read
 
-- Simple text searches (use Grep)
-- Reading configuration files (use Read)
-- Operations on non-code files (markdown, json, yaml)
-- When you need file content, not symbol info
+Never use Grep for code searches — use `search_for_pattern` or `find_symbol`.
 
-## Examples
+## Quick Reference
 
-| User Request | Action |
-|--------------|--------|
-| "Where is UserService used?" | find_referencing_symbols(name_path: "UserService") |
-| "Rename getUserData to fetchUser" | rename_symbol(name_path: "getUserData", new_name: "fetchUser") |
-| "What methods does AuthService have?" | find_symbol(name_path: "AuthService", depth: 1) |
-| "Find useAuth usage in Vue files" | search_for_pattern(pattern: "useAuth", glob: "**/*.vue") |
-| "Search in plugins folder" | search_for_pattern(relative_path: "plugins/custom") |
-| "List plugins directory" | list_dir(relative_path: "plugins", skip_ignored_files: false) |
-| "Show me the user.ts file" | Native Read (full file needed) |
+| Request | Tool |
+|---------|------|
+| "Where is UserService used?" | `find_referencing_symbols(name_path: "UserService")` |
+| "Rename getUserData to fetchUser" | `rename_symbol(name_path: "getUserData", new_name: "fetchUser")` |
+| "What methods does AuthService have?" | `find_symbol(name_path: "AuthService", depth: 1)` |
+| "Find useAuth in Vue files" | `search_for_pattern(pattern: "useAuth", glob: "**/*.vue")` |
+| "Search in plugins folder" | `search_for_pattern(relative_path: "plugins/custom")` |
+| "List plugins directory" | `list_dir(relative_path: "plugins", skip_ignored_files: false)` |
+| "Show me user.ts" | Native Read |

package/plugins/ima-claude/skills/mcp-tavily/SKILL.md

@@ -5,16 +5,16 @@ description: Use Tavily MCP for web research and current information beyond know
 
 # Tavily MCP - Web Research & Current Information
 
-Use Tavily for current information and research instead of multiple WebFetch calls.
+Use Tavily for current information and multi-source research instead of multiple WebFetch calls.
 
-## MCP Tools
+## Tools
 
 | Tool | Purpose |
 |------|---------|
 | `mcp__tavily__search` | Web search with depth control |
 | `mcp__tavily__extract` | Extract content from specific URLs |
 
-## Basic Search
+## Search
 
 ```
 mcp__tavily__search
@@ -23,96 +23,73 @@ mcp__tavily__search
   max_results: 10
 ```
 
-**Key parameters**:
-- `query` (required): Search query string
-- `search_depth`: "basic" | "advanced" (default: "basic")
-- `max_results`: Number of results (default: 5)
-- `topic`: "general" | "news" (default: "general")
-- `days`: Limit results to last N days (optional)
-- `include_domains`: Array of domains to include (optional)
-- `exclude_domains`: Array of domains to exclude (optional)
+| Parameter | Values | Default |
+|-----------|--------|---------|
+| `query` | string | required |
+| `search_depth` | `basic` / `advanced` | `basic` |
+| `max_results` | number | 5 |
+| `topic` | `general` / `news` | `general` |
+| `days` | N (last N days) | — |
+| `include_domains` | array | — |
+| `exclude_domains` | array | — |
 
-## Search Depth Selection
+| Depth | Use Case |
+|-------|----------|
+| `basic` | Factual lookups, quick answers |
+| `advanced` | Comparisons, multiple perspectives |
 
-| Depth | Use Case | Response Time |
-|-------|----------|---------------|
-| `basic` | Standard factual lookups, quick answers | Fast |
-| `advanced` | Comprehensive research, comparisons, multiple perspectives | Slower, more thorough |
+## Query Patterns
 
-## Query Optimization
-
-**Effective queries**:
-- Include year: "React 19 features 2026"
-- Be specific: "Vite 6 breaking changes" not "Vite updates"
-- Add context: "TypeScript 5.5 new utility types"
+| Need | Pattern |
+|------|---------|
+| Latest features | `"[library] [version] new features [year]"` |
+| Breaking changes | `"[library] [version] migration breaking changes"` |
+| Comparisons | `"[tool A] vs [tool B] comparison [year]"` |
+| Best practices | `"[topic] best practices [year]"` |
 
-**Query patterns**:
-| Need | Query Pattern |
-|------|---------------|
-| Latest version features | "[library] [version] new features [year]" |
-| Breaking changes | "[library] [version] migration breaking changes" |
-| Comparisons | "[tool A] vs [tool B] comparison [year]" |
-| Best practices | "[topic] best practices [year]" |
+Always include year. Be specific: `"Vite 6 breaking changes"` not `"Vite updates"`.
 
-## Extract Content
+## Extract
 
 ```
 mcp__tavily__extract
   urls: ["https://example.com/article"]
 ```
 
-Extracts clean content from specific URLs.
-
 ## Decision Logic
 
 ```
-IF question requires post-January-2025 information:
-    → Use Tavily
-ELSE IF research needs multiple web sources:
-    → Use Tavily
-ELSE IF single known URL needed:
-    → Use native WebFetch
-ELSE IF question within Claude's knowledge:
-    → Use native Claude
-ELSE IF asking about library API (not "what's new"):
-    → Use Context7 instead
+Post-Jan-2025 info needed → Tavily
+Multi-source research needed → Tavily
+Single known URL → WebFetch
+Library API docs (not "what's new") → Context7
+Question within Claude's knowledge → native Claude
 ```
 
-## When NOT to Use
-
-- Library API documentation (use Context7)
-- Code symbol searches (use Serena)
-- Questions Claude already knows (pre-cutoff knowledge)
-- Single URL content extraction where native WebFetch works
-
 ## Examples
 
-| User Request | Action |
-|--------------|--------|
-| "What's new in Vue 4?" | tavily search(query: "Vue 4 new features 2026", search_depth: "basic") |
-| "Compare Bun vs Node 2026" | tavily search(query: "Bun vs Node.js comparison 2026", search_depth: "advanced") |
-| "Latest Vite features" | tavily search(query: "Vite latest features 2026") |
-| "How does useState work?" | Native Claude (known knowledge) |
-| "Quasar QDialog API" | Use Context7 (library docs) |
+| Request | Action |
+|---------|--------|
+| "What's new in Vue 4?" | `search(query: "Vue 4 new features 2026", search_depth: "basic")` |
+| "Compare Bun vs Node 2026" | `search(query: "Bun vs Node.js comparison 2026", search_depth: "advanced")` |
+| "How does useState work?" | Native Claude |
+| "Quasar QDialog API" | Context7 |
 
 ## Source Attribution
 
-After using Tavily, always include sources section:
+Always include after Tavily results:
 
 ```
 Sources:
-- [Official Vue Blog](https://blog.vuejs.org/...)
-- [Release Notes](https://github.com/vuejs/...)
+- [Source Name](https://url)
 ```
 
 ## Setup
 
-Requires Tavily API key. Install with:
 ```bash
+# Automated
 bun run scripts/setup-mcp.ts
-```
 
-Or manually:
-```bash
+# Manual
 claude mcp add --scope user -e TAVILY_API_KEY=your-key -- tavily npx -y tavily-mcp@latest
 ```