Skip to main content
skill CX Codex

solution-hunt — Claude Code skill: workarounds and installation

The solution-hunt Claude Code skill finds legitimate alternatives when a task hits a blocker. It searches local notes and skills, then looks through GitHub and documentation.

MIT ★ 26 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add wrg32786/aigent-os --skill solution-hunt -a claude-code
Open on GitHub

What solution-hunt does

solution-hunt examines a blocker and lays out three routes: fix its cause, take a permitted alternate path, or replace the component causing trouble. It weighs implementation speed, side-effect risk, maintainability, and cost, then presents the strongest three options with steps for each.

Searches cover the local $AIGENT_VAULT, its skill and chain records, GitHub, and documentation through mcp__tavily__tavily_search and mcp__tavily__tavily_extract. Those documentation searches depend on the corresponding MCP tools. Once a route is chosen, the skill can carry it out and record a new pattern or recurring failure in memory files.

It rules out evading access controls, authentication, paywalls, or request limits through exploits. It also forbids concealing actions from the principal and using credentials found in screenshots or logs.

What it helps with

  • find an alternate route around a blocked task
  • compare a root-cause fix with replacing a component
  • search local notes and external sources for a workaround
  • record a newly found solution pattern

Example prompts for the agent

  • Find a workaround: the build fails because a dependency is incompatible.
  • Analyze this authentication blocker and suggest permitted alternatives.
  • /solution-hunt

How to install solution-hunt

1Skills CLI (Vercel)

npx skills add wrg32786/aigent-os --skill solution-hunt -a claude-code

2Manually: put the files in place

~/.claude/skills/solution-hunt/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/solution-hunt/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about solution-hunt

How do I install solution-hunt in Claude Code?

Run npx skills add wrg32786/aigent-os --skill solution-hunt -a claude-code. The skill file is at ~/.claude/skills/solution-hunt/SKILL.md.

What does solution-hunt do?

It searches local memory, skills, GitHub, and documentation for legitimate ways around a blocker. It compares the options and can implement the selected route.

What does solution-hunt need to work?

Local searches use $AIGENT_VAULT. Documentation and web searches use mcp__tavily__tavily_search and mcp__tavily__tavily_extract; GitHub searches use mcp__github__search_repositories and mcp__github__search_code.

Source text

SKILL.md · MIT
---
name: solution-hunt
description: "Find creative workarounds using local memory and skills. Use when a blocker requires an alternate solution."
---

# /solution-hunt — Creative workaround engine

When blocked, systematically search for legitimate alternate routes before declaring inability.

## Trigger

`/solution-hunt <blocker description>` or `/solution-hunt` (asks for blocker)

## Flow

### 1. Define the blocker
From argument or ask: "What's blocking you?" Get a concrete description of what can't be done and why.

### 2. Search local memory
Grep the vault for related concepts, prior solutions, similar blockers:
```
Grep pattern: {blocker keywords} in $AIGENT_VAULT/
```

### 3. Search local skills
Read `$AIGENT_VAULT/memory/SKILL_LEDGER.md`. Prefix-match against taxonomy paths. Check `memory/SKILL_CHAINS.md` for prior chains that solved similar problems.

### 4. Search GitHub
```
mcp__github__search_repositories: "{blocker} workaround" OR "{blocker} alternative"
mcp__github__search_code: "{specific error or API}" language:typescript OR language:python
```

### 5. Search docs and web
```
mcp__tavily__tavily_search: "{blocker} workaround" OR "{blocker} alternative solution"
mcp__tavily__tavily_extract: {relevant doc URLs found}
```

### 6. Identify 3 routes

| Route | Description |
|-------|-------------|
| **Direct fix** | Solve the root cause — fix the bug, update the dep, change the config |
| **Workaround** | Legitimate alternate path — different API, different tool, decompose the task |
| **Replace component** | Swap the blocking tool/dependency entirely |

### 7. Rank by tradeoffs

| Factor | Weight |
|--------|--------|
| Speed to implement | High |
| Risk of side effects | High |
| Maintainability | Medium |
| Cost (tokens, API calls, money) | Medium |

### 8. Present top 3
For each route, show:
- Description (1-2 sentences)
- Tradeoffs (speed/risk/maintenance)
- Confidence (high/medium/low)
- Implementation steps (3-5 bullets)

### 9. Execute chosen path
On user selection, implement the chosen route. If it requires a new skill, route through `/skill-hunt`.

### 10. Capture learning
- If the solution involved a new pattern: log to `memory/SKILL_CHAINS.md`
- If it exposed a gap: log to `memory/SKILL_GAPS.md`
- If it fixed a recurring issue: log to `memory/FAILURE_MODES.md` via `/learn-from-failure`

## Hard Boundary

> Creative workaround means legitimate alternate route. NEVER:
> - Bypass access controls or authentication
> - Violate terms of service of any platform
> - Exploit security vulnerabilities
> - Hide behavior from the principal
> - Bypass paywalls or rate limits through exploits
> - Use credentials from screenshots or logs

Per [[Capability Expansion Doctrine]] — the authority matrix governs what the AIgent may do. Expansion does not override authority levels.

## Related

- [[concepts/Capability Expansion Doctrine]] — the doctrine this skill serves
- [[memory/SKILL_LEDGER]] — local capability index
- [[memory/SKILL_CHAINS]] — proven multi-skill sequences
- [[memory/FAILURE_MODES.md]] — where failure learnings land
- `/skill-hunt` — external search when local solutions don't exist
- `/learn-from-failure` — structured failure capture

© wrg32786 · MIT · wrg32786/aigent-os

Similar skills

SKILL.md skills catalog →
google-cloud-solution-architecture official google google-cloud-solution-architecture is a Claude Code skill for designing multi-service Google Cloud systems. It gathers workload or migration requirements before shaping a solution. CX Codex +1 5,980installs google-cloud-solution-agentic-ai-bidirectional-streaming official google google-cloud-solution-agentic-ai-bidirectional-streaming is a Claude Code skill for designing Google Cloud solutions for live bidirectional multimodal streams with AI agents. It supports technical guidance and safety monitoring. CX Codex +1 5,411installs opportunity-solution-tree phuryn Builds an Opportunity Solution Tree: outcome, customer needs, solutions, experiments. Use it when structuring discovery work or deciding what to build next. CX Codex +1 3,200installs aws-solution-architect Alireza Rezvani aws-solution-architect designs AWS architectures, produces IaC templates, and reviews cloud costs. Use it for serverless builds, AWS migration work, or CI/CD planning. CX Codex +1 1,586installs develop-solution-brief product-on-purpose develop-solution-brief turns a problem into a one-page brief: proposed approach, key features, trade-offs and risks. Useful before you write the full spec. CX Codex +1 873installs alibabacloud-tech-solution-animation-creation-auto-deploy aliyun alibabacloud-tech-solution-animation-creation-auto-deploy is a skill for animation deployment on Alibaba Cloud: sets up OSS, issues a Bailian API key, and launches ComfyUI and WebUI in Function Compute. CX Codex +1 411installs

From the same set58

The whole set →
Stuck The Stuck Claude Code skill guides an agent through possible next steps before it calls a task blocked. It activates when the agent runs out of ideas or is about to ask for help. CX Codex +1 ★ 26repo stars status The status Claude Code skill reports the current operating state of aigent-OS. Ask for a snapshot of its mode, objective, next action, or blockers. CX Codex +1 ★ 26repo stars start start — a Claude Code skill that opens a home screen on first launch or when work resumes. It guides setup or gives a brief status update with an action menu. CX Codex +1 ★ 26repo stars sprite-spec This Claude Code skill turns pixel-art character ideas into sprite specifications. It activates for character or sprite-sheet design, covering palettes, proportions, and animation states. CX Codex +1 ★ 26repo stars skill-recall This Claude Code skill matches a task with local skills. Run /skill-recall to find candidates or record a gap when none fit. CX Codex +1 ★ 26repo stars skill-hunt The skill-hunt Claude Code skill finds skills that fill a capability gap. It ranks candidates, checks a selected skill, then installs it in quarantine. CX Codex +1 ★ 26repo stars Skill Audit The Skill Audit Claude Code skill checks skill usage and whether descriptions match the prompts that trigger them. It also flags idle skills and recurring work with no matching skill. CX Codex +1 ★ 26repo stars ship-adapter The ship-adapter Claude Code skill turns schemas and API contracts into adapters. It runs for database adapters, API client wrappers, interface adapters, and data transformers. CX Codex +1 ★ 26repo stars

Project sponsors

Companies that keep this analytics open