# Autoresearch Toolfinder

> Find the right autonomous-research / autoresearch tool, framework, port, or skill for a research or engineering task. Searches a local cached index of two curated awesome-autoresearch lists (alvinreal + yibie, 550+ entries) and returns only the few matching tools, never loading the whole catalog into context. Use when the user wants to pick, compare, or set up an autoresearch loop, an AI-scientis…

- **Type:** Skill
- **Install:** `agentstack add skill-jajupmochi-agent-harness-autoresearch-toolfinder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jajupmochi](https://agentstack.voostack.com/s/jajupmochi)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jajupmochi](https://github.com/jajupmochi)
- **Source:** https://github.com/jajupmochi/agent-harness/tree/main/skills/general/autoresearch-toolfinder

## Install

```sh
agentstack add skill-jajupmochi-agent-harness-autoresearch-toolfinder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# autoresearch-toolfinder

Recommends tools from two curated **awesome-autoresearch** catalogs (550+ entries) WITHOUT
reading the whole list into context. You run a search script and read back only the top matches.

## How to use (token-efficient — follow this; do NOT cat the index)

The catalog is large. **Never read `data/index.json` directly** (that defeats the purpose).
Run the query script from the skill directory; it returns only the top candidates:

```bash
python3 scripts/query.py ""
# options:  --source alvinreal|yibie   --category ""   --limit 8   --json
python3 scripts/query.py --list-categories      # see sections + counts first
```

Examples:
- Apple-Silicon / MLX port:   `python3 scripts/query.py "apple silicon mlx mac metal"`
- End-to-end AI scientist:    `python3 scripts/query.py "ai scientist paper literature review" --source alvinreal`
- RL post-training loop:      `python3 scripts/query.py "reinforcement learning grpo post-training"`
- Trading strategy search:    `python3 scripts/query.py "trading strategy backtest" --source yibie`
- Browse a whole section:     `python3 scripts/query.py "" --category "Evaluation"`

Then: read the handful of `name + url + one-liner` results, pick the best 1-3 for the user's
actual context, and say why. Open a specific repo URL (WebFetch) only if the user wants depth.

## When to activate (auto)

Activate when the user is **choosing / comparing / setting up**: an autoresearch or
self-improvement loop; an AI-scientist or research-agent system; a hardware/platform port; a
domain adaptation (bio, materials, finance, vision, RL, kernels, robotics...); or an eval
harness — or asks "what should I use for autonomous research / overnight experiments on X".

Not this skill: to actually *run* a full autonomous research project end-to-end, use the
sibling `autoresearch` orchestration skill. This skill is the **catalog / finder** only.

## Keeping it current (update tracking)

`data/state.json` stores each upstream repo's commit SHA + sync time.

```bash
python3 scripts/check_updates.py     # cheap: 1 API call/repo, compares SHA, exits 1 if stale
python3 scripts/update_index.py      # re-fetch + re-parse both repos, rewrite the index
```

A weekly user systemd timer (`systemd/autoresearch-index.timer`) refreshes automatically;
`query.py` also prints a hint when the local index is older than 30 days.

## Sources
- [alvinreal/awesome-autoresearch](https://github.com/alvinreal/awesome-autoresearch) (CC0)
- [yibie/awesome-autoresearch](https://github.com/yibie/awesome-autoresearch)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jajupmochi](https://github.com/jajupmochi)
- **Source:** [jajupmochi/agent-harness](https://github.com/jajupmochi/agent-harness)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jajupmochi-agent-harness-autoresearch-toolfinder
- Seller: https://agentstack.voostack.com/s/jajupmochi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.