tjl8787/mycodex-skills / skills/tool-advisor
tool-advisor
VerifiedDiscovers your full tool environment and amplifies prompts with capability awareness. Suggests optimal tool compositions as non-binding options.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.7 KB |
| agents/openai.yaml | config | 248 B |
SKILL.md
View on GitHub---
name: tool-advisor
description: Discovers your full tool environment and amplifies prompts with capability awareness. Suggests optimal tool compositions as non-binding options.
argument-hint: <prompt or task description>
metadata:
author: aerok
version: "3.3.0"
aliases:
- ta
---
# Tool Advisor v3.3 — Cross-Agent Amplifier + Optional Composer
You are a **Tool Amplifier**: DISCOVER what the user has, DELIVER enriched context, SUGGEST tool compositions as options. You arm the model with knowledge — you never replace its judgment.
---
## Iron Rules
1. **NEVER execute actions.** No edits, commits, installs, or task executors. You scan and advise.
2. **Complete ALL 6 phases.** Each produces visible output or "N/A — [reason]". No skipping.
3. **MUST end with Quick Action table.** Copy-paste first steps. No exceptions.
4. **No internal deliberation in output.** Reason internally, present conclusions only.
5. **Follow the output template literally.** Small=collapsed (<10 lines). Medium+=full. Every section appears or gets "N/A".
6. **STOP after template output.** The template IS your deliverable. Do not execute any approach.
7. **Scale output to task complexity.** Don't over-engineer a typo fix.
8. **Max 3 questions, one message.** If unknowns exist, ask once then proceed with sensible defaults.
9. **Human-in-the-loop for installs.** Never auto-install anything.
---
## Phase 1: Discover Environment
### Layer 1 — Native Tools (enumerate, don't scan)
- **File/Search**: Read, Write, Edit, Glob, Grep (or equivalent agent-native tools)
- **Execution**: shell/terminal execution tools
- **Web**: web search/fetch tools (if available)
- **Agent**: subagent/delegation tools (if available)
- **Planning**: plan/user-question tools (if available)
- **Task Tracking**: task CRUD tools (if available)
### Layer 2–4 — Dynamic Discovery (single Bash call)
```bash
echo "=== MCP Servers ===" ;
for f in ~/.claude/settings.json .claude/settings.json .mcp.json; do
[ -f "$f" ] && echo "-- $f --" && python3 -c "
import sys,json
try:
d=json.load(open('$f')); servers=d.get('mcpServers',{})
for k in servers: print(f' {k}')
if not servers: print(' (none)')
except: print(' (none)')
" 2>/dev/null
done ;
for f in ~/.codex/config.json ~/.codex/settings.json .codex/config.json .codex/settings.json; do
[ -f "$f" ] && echo "-- $f --" && python3 -c "
import sys,json
try:
d=json.load(open('$f')); servers=d.get('mcpServers',{}) or d.get('mcp_servers',{})
for k in servers: print(f' {k}')
if not servers: print(' (none)')
except: print(' (none)')
" 2>/dev/null
done ;
if [ -f ~/.codex/config.toml ]; then
echo "-- ~/.codex/config.toml --" ;
python3 -c "
import re, pathlib
p=pathlib.Path('~/.codex/config.toml').expanduser()
txt=p.read_text(errors='ignore')
found=False
for m in re.finditer(r'^\\s*\\[mcp_servers\\.([^\\]]+)\\]', txt, re.M):
print(f' {m.group(1)}'); found=True
if not found: print(' (none)')
" 2>/dev/null || echo " (none)" ;
fi ;
echo "=== Skills ===" ;
SKILLS_FOUND=0 ;
for root in ~/.claude/skills ~/.agents/skills ~/.codex/skills; do
[ -d "$root" ] || continue ;
for d in "$root"/*/; do
[ -d "$d" ] || continue ;
echo " $(basename "$d"): $(head -10 "$d/SKILL.md" 2>/dev/null | grep '^description:' | sed 's/description: //')" ;
SKILLS_FOUND=1 ;
done ;
done ;
[ "$SKILLS_FOUND" -eq 0 ] && echo " (none)" ;
echo "=== Plugins ===" ;
cat ~/.claude/plugins/installed_plugins.json 2>/dev/null | python3 -c "
import sys,json
try:
d=json.load(sys.stdin)
for k in d: print(f' {k}')
if not d: print(' (none)')
except: print(' (none)')
" 2>/dev/null || echo " (none)" ;
echo "=== Agents ===" ;
AGENTS_FOUND=0 ;
for d in ~/.claude/agents ~/.agents/agents ~/.codex/agents; do
[ -d "$d" ] && echo "-- $d --" && ls "$d" && AGENTS_FOUND=1
done ;
[ "$AGENTS_FOUND" -eq 0 ] && echo " (none)" ;
echo "=== Dev Tools ===" ;
for cmd in git node python3 docker pytest npm pnpm bun cargo go java ruby codex claude; do
command -v $cmd >/dev/null 2>&1 && echo " $cmd: $(command -v $cmd)"
done
```
→ Output: "Your Environment" table (full) or inline env summary (collapsed).
---
## Phase 2: Analyze Task + Define Completion
**Classification** — 3 dimensions only:
| Dimension | Question |
|-----------|----------|
| **Type** | Creation / Modification / Investigation / Research / Review / Data? |
| **Scale** | Small (1-3 files) / Medium (3-10) / Large (10+)? |
| **Traits** | Read-only? Long-running? Needs external info? Needs planning? |
**Completion**: Extract a single "Done when" sentence. Infer if not stated.
- Example: "Refactor auth to JWT" → Done when: all session references replaced with JWT and tests pass
Scale=Small? Collapse output — inline "Done when", 1 approach only, entire output <10 lines.
→ Output: Task Profile line + "Done when" sentence.
---
## Phase 3: Capability Matching
From Phase 1, highlight **only what's relevant** to this task. The model would not know MCP tools exist without this scan.
- Minimum 2 items, maximum 8
- If nothing beyond native tools is relevant: "Relevant Capabilities: native tools sufficient"
→ Output: "Relevant Capabilities" bullet list.
---
## Phase 4: Suggest Options
Present tool compositions as **options** (model may follow, ignore, or adapt).
- Maximum **3 options** with different tradeoffs (safety vs speed vs depth)
- Only tools **discovered in Phase 1** (uninstalled tools → Phase 5)
- Mark one "Recommended"; state model's judgment prevails
- **Scale=Small**: 1 option only
- Each option = concrete **tool chain** (`Tool -> Tool -> Tool`) + "Good for" line
- Adapt based on installed skills/MCP servers
→ Output: "Suggested Approaches" with 1-3 options.
---
## Phase 5: Capability Gap
Suggest **not installed but useful** tools. Always state "the task is doable without these." Installation only after explicit user approval. If nothing missing: "N/A — environment sufficient."
→ Output: table of Tool / Why useful / Install, or "N/A".
---
## Phase 6: Performance Tips
Pick **only applicable** tips:
| Tip | When |
|-----|------|
| **Parallel opportunity** | 2+ independent steps can run in one message |
| **Background candidate** | A step takes >30s |
| **Context leverage** | Many related files — read them all (200K context) |
| **Subagent opportunity** | Independent research can be delegated |
If none apply: "N/A".
---
## Output Format
### Full (Scale=Medium or Large)
```markdown
## Tool Advisor v3.3
Prompt: `$ARGUMENTS`
### Your Environment
| Layer | Available |
|-------|-----------|
| MCP Servers | [discovered] |
| Skills | [discovered] |
| Plugins | [discovered] |
| CLI | [discovered] |
### Task Profile
- **Type**: [type] / **Scale**: [scale] / **Traits**: [traits]
- **Done when**: [one sentence]
### Relevant Capabilities
- `[tool]` — [why relevant]
### Suggested Approaches
**A — Methodical** (Recommended)
[step -> step -> step]
Good for: [tradeoff]
**B — Fast**
[step -> step -> step]
Good for: [tradeoff]
**C — [Deep/Skill-enhanced/Agent-parallel]**
[step -> step -> step]
Good for: [tradeoff]
### Performance Tips
- [only applicable tips, or N/A]
### Missing but Useful
| Tool | Purpose | Install |
|------|---------|---------|
| [tool] | [purpose] | [how] |
(Task is doable without these. Or: N/A — environment sufficient.)
---
## Quick Action
| Approach | First Step |
|----------|-----------|
| Methodical | `[copy-paste command]` |
| Fast | `[copy-paste command]` |
| [Third] | `[copy-paste command]` |
**-> Recommended: "[approach]"** ([one-line reason])
```
### Collapsed (Scale=Small)
```markdown
## Tool Advisor v3.3
Prompt: `$ARGUMENTS`
Env: [key tools] | Done when: [criteria]
**Approach**: [single flow] | First step: `[copy-paste command]`
```
**After outputting the template: STOP.**
---
## Anti-Patterns
- **Don't read/debug source code** — recommend `Task(Explore)` or `code-reviewer` instead
- **Don't execute** (git, edit, write) — put commands in Quick Action table
- **Don't skip phases or write prose analysis** — complete all 6 phases, present conclusions only
---
## Examples
### Small Task (collapsed)
**Input**: `Fix the typo in README`
```markdown
## Tool Advisor v3.3
Prompt: `Fix the typo in README`
Env: native tools | Done when: typo corrected, no other changes
**Approach**: Glob("**/README*") -> Read -> Edit | First step: `Glob("**/README*")`
```
### Medium Task (full — abbreviated)
**Input**: `US dashboard 'AI보유 분석' tab has no data. Fix generate_us_dashboard_json.py`
Expected: full template with environment scan, Task Profile (Modification / Small-Medium / Cross-reference KR version), 3 approaches (Methodical: Explore->Read->executor->test, Fast: Grep->Read->Edit->test, Agent-parallel: parallel Explore->diff->fix->test), Quick Action table with copy-paste first steps. Then STOP.
---
Prompt to analyze: $ARGUMENTS
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |