[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75Q8WFXGDWWGSGXGHJM99RB":3,"skill-same:01M75Q8WFXGDWWGSGXGHJM99RB":72},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":13,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":33,"install":34,"resources":47},"01M75Q8WFXGDWWGSGXGHJM99RB","autoresearch-agent",null,"Autonomous experiment loop that optimizes any file by a measurable metric. Inspired by Karpathy's autoresearch. The agent edits a target file, runs a fixed evaluation, keeps improvements (git commit), discards failures (git reset), and loops indefinitely. Use when: user wants to optimize code speed, reduce bundle\u002Fimage size, improve test pass rate, optimize prompts, improve content quality (headlines, copy, CTR), or run any measurable improvement loop. Requires: a target file, an evaluation command that outputs a metric, and a git repo.","TehutiRaEl\u002FTHEHIVE","TehutiRaEl","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F267495122?v=4","01M75N1QQQHT359S3XMYK7NPCB","01M75N1QRAW5P8P43HEHWMXCTE",0,"MIT","https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE\u002Fblob\u002Fmain\u002Fskills-library\u002Fengineering\u002Fautoresearch-agent\u002Fskills\u002Fautoresearch-agent\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: \"autoresearch-agent\"\ndescription: \"Autonomous experiment loop that optimizes any file by a measurable metric. Inspired by Karpathy's autoresearch. The agent edits a target file, runs a fixed evaluation, keeps improvements (git commit), discards failures (git reset), and loops indefinitely. Use when: user wants to optimize code speed, reduce bundle\u002Fimage size, improve test pass rate, optimize prompts, improve content quality (headlines, copy, CTR), or run any measurable improvement loop. Requires: a target file, an evaluation command that outputs a metric, and a git repo.\"\nlicense: MIT\nmetadata:\n  version: 2.0.0\n  author: Alireza Rezvani\n  category: engineering\n  updated: 2026-03-13\n---\n\n# Autoresearch Agent\n\n> You sleep. The agent experiments. You wake up to results.\n\nAutonomous experiment loop inspired by [Karpathy's autoresearch](https:\u002F\u002Fgithub.com\u002Fkarpathy\u002Fautoresearch). The agent edits one file, runs a fixed evaluation, keeps improvements, discards failures, and loops indefinitely.\n\nNot one guess — fifty measured attempts, compounding.\n\n---\n\n## Slash Commands\n\n| Command | What it does |\n|---------|-------------|\n| `\u002Far:setup` | Set up a new experiment interactively |\n| `\u002Far:run` | Run a single experiment iteration |\n| `\u002Far:loop` | Start autonomous loop with configurable interval (10m, 1h, daily, weekly, monthly) |\n| `\u002Far:status` | Show dashboard and results |\n| `\u002Far:resume` | Resume a paused experiment |\n\n---\n\n## When This Skill Activates\n\nRecognize these patterns from the user:\n\n- \"Make this faster \u002F smaller \u002F better\"\n- \"Optimize [file] for [metric]\"\n- \"Improve my [headlines \u002F copy \u002F prompts]\"\n- \"Run experiments overnight\"\n- \"I want to get [metric] from X to Y\"\n- Any request involving: optimize, benchmark, improve, experiment loop, autoresearch\n\nIf the user describes a target file + a way to measure success → this skill applies.\n\n---\n\n## Setup\n\n### First Time — Create the Experiment\n\nRun the setup script. The user decides where experiments live:\n\n**Project-level** (inside repo, git-tracked, shareable with team):\n```bash\npython scripts\u002Fsetup_experiment.py \\\n  --domain engineering \\\n  --name api-speed \\\n  --target src\u002Fapi\u002Fsearch.py \\\n  --eval \"pytest bench.py --tb=no -q\" \\\n  --metric p50_ms \\\n  --direction lower \\\n  --scope project\n```\n\n**User-level** (personal, in `~\u002F.autoresearch\u002F`):\n```bash\npython scripts\u002Fsetup_experiment.py \\\n  --domain marketing \\\n  --name medium-ctr \\\n  --target content\u002Ftitles.md \\\n  --eval \"python evaluate.py\" \\\n  --metric ctr_score \\\n  --direction higher \\\n  --evaluator llm_judge_content \\\n  --scope user\n```\n\nThe `--scope` flag determines where `.autoresearch\u002F` lives:\n- `project` (default) → `.autoresearch\u002F` in the repo root. Experiment definitions are git-tracked. Results are gitignored.\n- `user` → `~\u002F.autoresearch\u002F` in the home directory. Everything is personal.\n\n### What Setup Creates\n\n```\n.autoresearch\u002F\n├── config.yaml                        ← Global settings\n├── .gitignore                         ← Ignores results.tsv, *.log\n└── {domain}\u002F{experiment-name}\u002F\n    ├── program.md                     ← Objectives, constraints, strategy\n    ├── config.cfg                     ← Target, eval cmd, metric, direction\n    ├── results.tsv                    ← Experiment log (gitignored)\n    └── evaluate.py                    ← Evaluation script (if --evaluator used)\n```\n\n**results.tsv columns:** `commit | metric | status | description`\n- `commit` — short git hash\n- `metric` — float value or \"N\u002FA\" for crashes\n- `status` — keep | discard | crash\n- `description` — what changed or why it crashed\n\n### Domains\n\n| Domain | Use Cases |\n|--------|-----------|\n| `engineering` | Code speed, memory, bundle size, test pass rate, build time |\n| `marketing` | Headlines, social copy, email subjects, ad copy, engagement |\n| `content` | Article structure, SEO descriptions, readability, CTR |\n| `prompts` | System prompts, chatbot tone, agent instructions |\n| `custom` | Anything else with a measurable metric |\n\n### If `program.md` Already Exists\n\nThe user may have written their own `program.md`. If found in the experiment directory, read it. It overrides the template. Only ask for what's missing.\n\n---\n\n## Agent Protocol\n\nYou are the loop. The scripts handle setup and evaluation — you handle the creative work.\n\n### Before Starting\n1. Read `.autoresearch\u002F{domain}\u002F{name}\u002Fconfig.cfg` to get:\n   - `target` — the file you edit\n   - `evaluate_cmd` — the command that measures your changes\n   - `metric` — the metric name to look for in eval output\n   - `metric_direction` — \"lower\" or \"higher\" is better\n   - `time_budget_minutes` — max time per evaluation\n2. Read `program.md` for strategy, constraints, and what you can\u002Fcannot change\n3. Read `results.tsv` for experiment history (columns: commit, metric, status, description)\n4. Checkout the experiment branch: `git checkout autoresearch\u002F{domain}\u002F{name}`\n\n### Each Iteration\n1. Review results.tsv — what worked? What failed? What hasn't been tried?\n2. Decide ONE change to the target file. One variable per experiment.\n3. Edit the target file\n4. Commit: `git add {target} && git commit -m \"experiment: {description}\"`\n5. Evaluate: `python scripts\u002Frun_experiment.py --experiment {domain}\u002F{name} --single`\n6. Read the output — it prints KEEP, DISCARD, or CRASH with the metric value\n7. Go to step 1\n\n### What the Script Handles (you don't)\n- Running the eval command with timeout\n- Parsing the metric from eval output\n- Comparing to previous best\n- Reverting the commit on failure (`git reset --hard HEAD~1`)\n- Logging the result to results.tsv\n\n### Starting an Experiment\n\n```bash\n# Single iteration (the agent calls this repeatedly)\npython scripts\u002Frun_experiment.py --experiment engineering\u002Fapi-speed --single\n\n# Dry run (test setup before starting)\npython scripts\u002Frun_experiment.py --experiment engineering\u002Fapi-speed --dry-run\n```\n\n### Strategy Escalation\n- Runs 1-5: Low-hanging fruit (obvious improvements, simple optimizations)\n- Runs 6-15: Systematic exploration (vary one parameter at a time)\n- Runs 16-30: Structural changes (algorithm swaps, architecture shifts)\n- Runs 30+: Radical experiments (completely different approaches)\n- If no improvement in 20+ runs: update program.md Strategy section\n\n### Self-Improvement\nAfter every 10 experiments, review results.tsv for patterns. Update the\nStrategy section of program.md with what you learned (e.g., \"caching changes\nconsistently improve by 5-10%\", \"refactoring attempts never improve the metric\").\nFuture iterations benefit from this accumulated knowledge.\n\n### Stopping\n- Run until interrupted by the user, context limit reached, or goal in program.md is met\n- Before stopping: ensure results.tsv is up to date\n- On context limit: the next session can resume — results.tsv and git log persist\n\n### Rules\n\n- **One change per experiment.** Don't change 5 things at once. You won't know what worked.\n- **Simplicity criterion.** A small improvement that adds ugly complexity is not worth it. Equal performance with simpler code is a win. Removing code that gets same results is the best outcome.\n- **Never modify the evaluator.** `evaluate.py` is the ground truth. Modifying it invalidates all comparisons. Hard stop if you catch yourself doing this.\n- **Timeout.** If a run exceeds 2.5× the time budget, kill it and treat as crash.\n- **Crash handling.** If it's a typo or missing import, fix and re-run. If the idea is fundamentally broken, revert, log \"crash\", move on. 5 consecutive crashes → pause and alert.\n- **No new dependencies.** Only use what's already available in the project.\n\n---\n\n## Evaluators\n\nReady-to-use evaluation scripts. Copied into the experiment directory during setup with `--evaluator`.\n\n### Free Evaluators (no API cost)\n\n| Evaluator | Metric | Use Case |\n|-----------|--------|----------|\n| `benchmark_speed` | `p50_ms` (lower) | Function\u002FAPI execution time |\n| `benchmark_size` | `size_bytes` (lower) | File, bundle, Docker image size |\n| `test_pass_rate` | `pass_rate` (higher) | Test suite pass percentage |\n| `build_speed` | `build_seconds` (lower) | Build\u002Fcompile\u002FDocker build time |\n| `memory_usage` | `peak_mb` (lower) | Peak memory during execution |\n\n### LLM Judge Evaluators (uses your subscription)\n\n| Evaluator | Metric | Use Case |\n|-----------|--------|----------|\n| `llm_judge_content` | `ctr_score` 0-10 (higher) | Headlines, titles, descriptions |\n| `llm_judge_prompt` | `quality_score` 0-100 (higher) | System prompts, agent instructions |\n| `llm_judge_copy` | `engagement_score` 0-10 (higher) | Social posts, ad copy, emails |\n\nLLM judges call the CLI tool the user is already running (Claude, Codex, Gemini). The evaluation prompt is locked inside `evaluate.py` — the agent cannot modify it. This prevents the agent from gaming its own evaluator.\n\nThe user's existing subscription covers the cost:\n- Claude Code Max → unlimited Claude calls for evaluation\n- Codex CLI (ChatGPT Pro) → unlimited Codex calls\n- Gemini CLI (free tier) → free evaluation calls\n\n### Custom Evaluators\n\nIf no built-in evaluator fits, the user writes their own `evaluate.py`. Only requirement: it must print `metric_name: value` to stdout.\n\n```python\n#!\u002Fusr\u002Fbin\u002Fenv python3\n# My custom evaluator — DO NOT MODIFY after experiment starts\nimport subprocess\nresult = subprocess.run([\"my-benchmark\", \"--json\"], capture_output=True, text=True)\n# Parse and output\nprint(f\"my_metric: {parse_score(result.stdout)}\")\n```\n\n---\n\n## Viewing Results\n\n```bash\n# Single experiment\npython scripts\u002Flog_results.py --experiment engineering\u002Fapi-speed\n\n# All experiments in a domain\npython scripts\u002Flog_results.py --domain engineering\n\n# Cross-experiment dashboard\npython scripts\u002Flog_results.py --dashboard\n\n# Export formats\npython scripts\u002Flog_results.py --experiment engineering\u002Fapi-speed --format csv --output results.csv\npython scripts\u002Flog_results.py --experiment engineering\u002Fapi-speed --format markdown --output results.md\npython scripts\u002Flog_results.py --dashboard --format markdown --output dashboard.md\n```\n\n### Dashboard Output\n\n```\nDOMAIN          EXPERIMENT          RUNS  KEPT  BEST         Δ FROM START  STATUS\nengineering     api-speed            47    14   185ms        -76.9%        active\nengineering     bundle-size          23     8   412KB        -58.3%        paused\nmarketing       medium-ctr           31    11   8.4\u002F10       +68.0%        active\nprompts         support-tone         15     6   82\u002F100       +46.4%        done\n```\n\n### Export Formats\n\n- **TSV** — default, tab-separated (compatible with spreadsheets)\n- **CSV** — comma-separated, with proper quoting\n- **Markdown** — formatted table, readable in GitHub\u002Fdocs\n\n---\n\n## Proactive Triggers\n\nFlag these without being asked:\n\n- **No evaluation command works** → Test it before starting the loop. Run once, verify output.\n- **Target file not in git** → `git init && git add . && git commit -m 'initial'` first.\n- **Metric direction unclear** → Ask: is lower or higher better? Must know before starting.\n- **Time budget too short** → If eval takes longer than budget, every run crashes.\n- **Agent modifying evaluate.py** → Hard stop. This invalidates all comparisons.\n- **5 consecutive crashes** → Pause the loop. Alert the user. Don't keep burning cycles.\n- **No improvement in 20+ runs** → Suggest changing strategy in program.md or trying a different approach.\n\n---\n\n## Installation\n\n### One-liner (any tool)\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Falirezarezvani\u002Fclaude-skills.git\ncp -r claude-skills\u002Fengineering\u002Fautoresearch-agent ~\u002F.claude\u002Fskills\u002F\n```\n\n### Multi-tool install\n```bash\n.\u002Fscripts\u002Fconvert.sh --skill autoresearch-agent --tool codex|gemini|cursor|windsurf|openclaw\n```\n\n### OpenClaw\n```bash\nclawhub install cs-autoresearch-agent\n```\n\n---\n\n## Related Skills\n\n- **self-improving-agent** — improves an agent's own memory\u002Frules over time. NOT for structured experiment loops.\n- **senior-ml-engineer** — ML architecture decisions. Complementary — use for initial design, then autoresearch for optimization.\n- **tdd-guide** — test-driven development. Complementary — tests can be the evaluation function.\n- **skill-security-auditor** — audit skills before publishing. NOT for optimization loops.\n","# Autoresearch Agent\n\n> You sleep. The agent experiments. You wake up to results.\n\nAutonomous experiment loop inspired by [Karpathy's autoresearch](https:\u002F\u002Fgithub.com\u002Fkarpathy\u002Fautoresearch). The agent edits one file, runs a fixed evaluation, keeps improvements, discards failures, and loops indefinitely.\n\nNot one guess — fifty measured attempts, compounding.\n\n---\n\n## Slash Commands\n\n| Command | What it does |\n|---------|-------------|\n| `\u002Far:setup` | Set up a new experiment interactively |\n| `\u002Far:run` | Run a single experiment iteration |\n| `\u002Far:loop` | Start autonomous loop with configurable interval (10m, 1h, daily, weekly, monthly) |\n| `\u002Far:status` | Show dashboard and results |\n| `\u002Far:resume` | Resume a paused experiment |\n\n---\n\n## When This Skill Activates\n\nRecognize these patterns from the user:\n\n- \"Make this faster \u002F smaller \u002F better\"\n- \"Optimize [file] for [metric]\"\n- \"Improve my [headlines \u002F copy \u002F prompts]\"\n- \"Run experiments overnight\"\n- \"I want to get [metric] from X to Y\"\n- Any request involving: optimize, benchmark, improve, experiment loop, autoresearch\n\nIf the user describes a target file + a way to measure success → this skill applies.\n\n---\n\n## Setup\n\n### First Time — Create the Experiment\n\nRun the setup script. The user decides where experiments live:\n\n**Project-level** (inside repo, git-tracked, shareable with team):\n```bash\npython scripts\u002Fsetup_experiment.py \\\n  --domain engineering \\\n  --name api-speed \\\n  --target src\u002Fapi\u002Fsearch.py \\\n  --eval \"pytest bench.py --tb=no -q\" \\\n  --metric p50_ms \\\n  --direction lower \\\n  --scope project\n```\n\n**User-level** (personal, in `~\u002F.autoresearch\u002F`):\n```bash\npython scripts\u002Fsetup_experiment.py \\\n  --domain marketing \\\n  --name medium-ctr \\\n  --target content\u002Ftitles.md \\\n  --eval \"python evaluate.py\" \\\n  --metric ctr_score \\\n  --direction higher \\\n  --evaluator llm_judge_content \\\n  --scope user\n```\n\nThe `--scope` flag determines where `.autoresearch\u002F` lives:\n- `project` (default) → `.autoresearch\u002F` in the repo root. Experiment definitions are git-tracked. Results are gitignored.\n- `user` → `~\u002F.autoresearch\u002F` in the home directory. Everything is personal.\n\n### What Setup Creates\n\n```\n.autoresearch\u002F\n├── config.yaml                        ← Global settings\n├── .gitignore                         ← Ignores results.tsv, *.log\n└── {domain}\u002F{experiment-name}\u002F\n    ├── program.md                     ← Objectives, constraints, strategy\n    ├── config.cfg                     ← Target, eval cmd, metric, direction\n    ├── results.tsv                    ← Experiment log (gitignored)\n    └── evaluate.py                    ← Evaluation script (if --evaluator used)\n```\n\n**results.tsv columns:** `commit | metric | status | description`\n- `commit` — short git hash\n- `metric` — float value or \"N\u002FA\" for crashes\n- `status` — keep | discard | crash\n- `description` — what changed or why it crashed\n\n### Domains\n\n| Domain | Use Cases |\n|--------|-----------|\n| `engineering` | Code speed, memory, bundle size, test pass rate, build time |\n| `marketing` | Headlines, social copy, email subjects, ad copy, engagement |\n| `content` | Article structure, SEO descriptions, readability, CTR |\n| `prompts` | System prompts, chatbot tone, agent instructions |\n| `custom` | Anything else with a measurable metric |\n\n### If `program.md` Already Exists\n\nThe user may have written their own `program.md`. If found in the experiment directory, read it. It overrides the template. Only ask for what's missing.\n\n---\n\n## Agent Protocol\n\nYou are the loop. The scripts handle setup and evaluation — you handle the creative work.\n\n### Before Starting\n1. Read `.autoresearch\u002F{domain}\u002F{name}\u002Fconfig.cfg` to get:\n   - `target` — the file you edit\n   - `evaluate_cmd` — the command that measures your changes\n   - `metric` — the metric name to look for in eval output\n   - `metric_direction` — \"lower\" or \"higher\" is better\n   - `time_budget_minutes` — max time per evaluation\n2. Read `program.md` for strategy, constraints, and what you can\u002Fcannot change\n3. Read `results.tsv` for experiment history (columns: commit, metric, status, description)\n4. Checkout the experiment branch: `git checkout autoresearch\u002F{domain}\u002F{name}`\n\n### Each Iteration\n1. Review results.tsv — what worked? What failed? What hasn't been tried?\n2. Decide ONE change to the target file. One variable per experiment.\n3. Edit the target file\n4. Commit: `git add {target} && git commit -m \"experiment: {description}\"`\n5. Evaluate: `python scripts\u002Frun_experiment.py --experiment {domain}\u002F{name} --single`\n6. Read the output — it prints KEEP, DISCARD, or CRASH with the metric value\n7. Go to step 1\n\n### What the Script Handles (you don't)\n- Running the eval command with timeout\n- Parsing the metric from eval output\n- Comparing to previous best\n- Reverting the commit on failure (`git reset --hard HEAD~1`)\n- Logging the result to results.tsv\n\n### Starting an Experiment\n\n```bash\n# Single iteration (the agent calls this repeatedly)\npython scripts\u002Frun_experiment.py --experiment engineering\u002Fapi-speed --single\n\n# Dry run (test setup before starting)\npython scripts\u002Frun_experiment.py --experiment engineering\u002Fapi-speed --dry-run\n```\n\n### Strategy Escalation\n- Runs 1-5: Low-hanging fruit (obvious improvements, simple optimizations)\n- Runs 6-15: Systematic exploration (vary one parameter at a time)\n- Runs 16-30: Structural changes (algorithm swaps, architecture shifts)\n- Runs 30+: Radical experiments (completely different approaches)\n- If no improvement in 20+ runs: update program.md Strategy section\n\n### Self-Improvement\nAfter every 10 experiments, review results.tsv for patterns. Update the\nStrategy section of program.md with what you learned (e.g., \"caching changes\nconsistently improve by 5-10%\", \"refactoring attempts never improve the metric\").\nFuture iterations benefit from this accumulated knowledge.\n\n### Stopping\n- Run until interrupted by the user, context limit reached, or goal in program.md is met\n- Before stopping: ensure results.tsv is up to date\n- On context limit: the next session can resume — results.tsv and git log persist\n\n### Rules\n\n- **One change per experiment.** Don't change 5 things at once. You won't know what worked.\n- **Simplicity criterion.** A small improvement that adds ugly complexity is not worth it. Equal performance with simpler code is a win. Removing code that gets same results is the best outcome.\n- **Never modify the evaluator.** `evaluate.py` is the ground truth. Modifying it invalidates all comparisons. Hard stop if you catch yourself doing this.\n- **Timeout.** If a run exceeds 2.5× the time budget, kill it and treat as crash.\n- **Crash handling.** If it's a typo or missing import, fix and re-run. If the idea is fundamentally broken, revert, log \"crash\", move on. 5 consecutive crashes → pause and alert.\n- **No new dependencies.** Only use what's already available in the project.\n\n---\n\n## Evaluators\n\nReady-to-use evaluation scripts. Copied into the experiment directory during setup with `--evaluator`.\n\n### Free Evaluators (no API cost)\n\n| Evaluator | Metric | Use Case |\n|-----------|--------|----------|\n| `benchmark_speed` | `p50_ms` (lower) | Function\u002FAPI execution time |\n| `benchmark_size` | `size_bytes` (lower) | File, bundle, Docker image size |\n| `test_pass_rate` | `pass_rate` (higher) | Test suite pass percentage |\n| `build_speed` | `build_seconds` (lower) | Build\u002Fcompile\u002FDocker build time |\n| `memory_usage` | `peak_mb` (lower) | Peak memory during execution |\n\n### LLM Judge Evaluators (uses your subscription)\n\n| Evaluator | Metric | Use Case |\n|-----------|--------|----------|\n| `llm_judge_content` | `ctr_score` 0-10 (higher) | Headlines, titles, descriptions |\n| `llm_judge_prompt` | `quality_score` 0-100 (higher) | System prompts, agent instructions |\n| `llm_judge_copy` | `engagement_score` 0-10 (higher) | Social posts, ad copy, emails |\n\nLLM judges call the CLI tool the user is already running (Claude, Codex, Gemini). The evaluation prompt is locked inside `evaluate.py` — the agent cannot modify it. This prevents the agent from gaming its own evaluator.\n\nThe user's existing subscription covers the cost:\n- Claude Code Max → unlimited Claude calls for evaluation\n- Codex CLI (ChatGPT Pro) → unlimited Codex calls\n- Gemini CLI (free tier) → free evaluation calls\n\n### Custom Evaluators\n\nIf no built-in evaluator fits, the user writes their own `evaluate.py`. Only requirement: it must print `metric_name: value` to stdout.\n\n```python\n#!\u002Fusr\u002Fbin\u002Fenv python3\n# My custom evaluator — DO NOT MODIFY after experiment starts\nimport subprocess\nresult = subprocess.run([\"my-benchmark\", \"--json\"], capture_output=True, text=True)\n# Parse and output\nprint(f\"my_metric: {parse_score(result.stdout)}\")\n```\n\n---\n\n## Viewing Results\n\n```bash\n# Single experiment\npython scripts\u002Flog_results.py --experiment engineering\u002Fapi-speed\n\n# All experiments in a domain\npython scripts\u002Flog_results.py --domain engineering\n\n# Cross-experiment dashboard\npython scripts\u002Flog_results.py --dashboard\n\n# Export formats\npython scripts\u002Flog_results.py --experiment engineering\u002Fapi-speed --format csv --output results.csv\npython scripts\u002Flog_results.py --experiment engineering\u002Fapi-speed --format markdown --output results.md\npython scripts\u002Flog_results.py --dashboard --format markdown --output dashboard.md\n```\n\n### Dashboard Output\n\n```\nDOMAIN          EXPERIMENT          RUNS  KEPT  BEST         Δ FROM START  STATUS\nengineering     api-speed            47    14   185ms        -76.9%        active\nengineering     bundle-size          23     8   412KB        -58.3%        paused\nmarketing       medium-ctr           31    11   8.4\u002F10       +68.0%        active\nprompts         support-tone         15     6   82\u002F100       +46.4%        done\n```\n\n### Export Formats\n\n- **TSV** — default, tab-separated (compatible with spreadsheets)\n- **CSV** — comma-separated, with proper quoting\n- **Markdown** — formatted table, readable in GitHub\u002Fdocs\n\n---\n\n## Proactive Triggers\n\nFlag these without being asked:\n\n- **No evaluation command works** → Test it before starting the loop. Run once, verify output.\n- **Target file not in git** → `git init && git add . && git commit -m 'initial'` first.\n- **Metric direction unclear** → Ask: is lower or higher better? Must know before starting.\n- **Time budget too short** → If eval takes longer than budget, every run crashes.\n- **Agent modifying evaluate.py** → Hard stop. This invalidates all comparisons.\n- **5 consecutive crashes** → Pause the loop. Alert the user. Don't keep burning cycles.\n- **No improvement in 20+ runs** → Suggest changing strategy in program.md or trying a different approach.\n\n---\n\n## Installation\n\n### One-liner (any tool)\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Falirezarezvani\u002Fclaude-skills.git\ncp -r claude-skills\u002Fengineering\u002Fautoresearch-agent ~\u002F.claude\u002Fskills\u002F\n```\n\n### Multi-tool install\n```bash\n.\u002Fscripts\u002Fconvert.sh --skill autoresearch-agent --tool codex|gemini|cursor|windsurf|openclaw\n```\n\n### OpenClaw\n```bash\nclawhub install cs-autoresearch-agent\n```\n\n---\n\n## Related Skills\n\n- **self-improving-agent** — improves an agent's own memory\u002Frules over time. NOT for structured experiment loops.\n- **senior-ml-engineer** — ML architecture decisions. Complementary — use for initial design, then autoresearch for optimization.\n- **tdd-guide** — test-driven development. Complementary — tests can be the evaluation function.\n- **skill-security-auditor** — audit skills before publishing. NOT for optimization loops.\n",{"name":5,"license":14,"metadata":23,"description":7},{"author":24,"updated":25,"version":26,"category":27},"Alireza Rezvani",1773360000000,"2.0.0","engineering","main","b4ebd6d8c3b36347a5d435bcb343a5fc1c6f08d1","skills-library\u002Fengineering\u002Fautoresearch-agent\u002Fskills\u002Fautoresearch-agent","https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE","https:\u002F\u002Fgithub.com\u002FTehutiRaEl","2026-11-15 04:00:21",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add TehutiRaEl\u002FTHEHIVE --skill autoresearch-agent",{"tool":40,"command":41},"bunx","bunx skills add TehutiRaEl\u002FTHEHIVE --skill autoresearch-agent",{"tool":43,"command":44},"pnpm","pnpm dlx skills add TehutiRaEl\u002FTHEHIVE --skill autoresearch-agent","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE\u002Fblob\u002Fmain\u002Fskills-library\u002Fengineering\u002Fautoresearch-agent\u002Fskills\u002Fautoresearch-agent\u002FSKILL.md",true,[48,54,58,64,68],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"references\u002Fexperiment-domains.md","REFERENCE","参考文档",6672,"https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE\u002Fblob\u002Fmain\u002Fskills-library\u002Fengineering\u002Fautoresearch-agent\u002Fskills\u002Fautoresearch-agent\u002Freferences\u002Fexperiment-domains.md",{"path":55,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Fprogram-template.md",4819,"https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE\u002Fblob\u002Fmain\u002Fskills-library\u002Fengineering\u002Fautoresearch-agent\u002Fskills\u002Fautoresearch-agent\u002Freferences\u002Fprogram-template.md",{"path":59,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":62,"sourceHtmlUrl":63},"scripts\u002Flog_results.py","SCRIPT","脚本",15327,"https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE\u002Fblob\u002Fmain\u002Fskills-library\u002Fengineering\u002Fautoresearch-agent\u002Fskills\u002Fautoresearch-agent\u002Fscripts\u002Flog_results.py",{"path":65,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":66,"sourceHtmlUrl":67},"scripts\u002Frun_experiment.py",9821,"https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE\u002Fblob\u002Fmain\u002Fskills-library\u002Fengineering\u002Fautoresearch-agent\u002Fskills\u002Fautoresearch-agent\u002Fscripts\u002Frun_experiment.py",{"path":69,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":70,"sourceHtmlUrl":71},"scripts\u002Fsetup_experiment.py",14341,"https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE\u002Fblob\u002Fmain\u002Fskills-library\u002Fengineering\u002Fautoresearch-agent\u002Fskills\u002Fautoresearch-agent\u002Fscripts\u002Fsetup_experiment.py",[73,80,86,93,100,107],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M76XP63XDM4PFPX8MMVYN9JX","preamble-gate","Use BEFORE doing any work in this repo — before the first file edit, commit, push, PR, branch operation, workflow dispatch, scheduled trigger or timer, agent\u002Fsubagent spawn, dependency install, or message sent to an outside service. Forces a plain-language preamble to the founder first: WHAT you are about to do, WHY, HOW, why it is NECESSARY, the PROJECTED IMPROVEMENT, and the COST and RISK — then, for consequential work (governance, security, money, CI\u002Ftriggers, rewriting history, multi-agent fan-out), waits for an explicit go-ahead. Read-only investigation (reading files, grep, git log\u002Fdiff, answering questions) is exempt. Applies to every AI that works in this repo, not just Claude. Founder rule, 2026-11-10, written after an unattended automation ran up cost and froze the hive. Not a substitute for wired-or-not (which governs how completion is CLAIMED); this governs what happens BEFORE work starts.","https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fpreamble-gate\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M75RAYXC1W361YR9NBXD59AM","visionary-recommender","https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE\u002Fblob\u002Fmain\u002Fskills\u002Fvisionary-recommender\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":18},"01M75RAQN9Q450RD57J2S6FSR4","syllabus","Generates a curated supplementary reading list from any course syllabus using Consensus academic search. Grill-me intake (syllabus input format + course audience + year range) plus a grouping forcing-options checkpoint before any search runs — so the reading list matches the course's level and recency need. Parses the syllabus to extract topics and learning outcomes, searches Consensus for recent peer-reviewed papers per topic, and produces a professionally formatted .docx with clickable Consensus links, plain-language summaries calibrated to audience level, and Bloom-higher-order discussion questions tied to course learning goals. Use when the user uploads a syllabus, course outline, or curriculum document and wants supplementary readings (e.g., 'create a reading list from this syllabus', 'find recent papers for my course') — even casual mentions with a syllabus attached should trigger this skill.","https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE\u002Fblob\u002Fmain\u002Fskills-library\u002Fresearch\u002Fsyllabus\u002Fskills\u002Fsyllabus\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":18},"01M75RAG1XMCJMF30HFV5S79AK","research","Default entry point for any research request — a hybrid router that classifies the question deterministically and either delegates to a specialist research skill (pulse for trends\u002Fsentiment, grants for NIH funding, litreview for academic literature, syllabus for course reading, patent for prior-art + IP landscape, dossier for entity research) or runs its own plan-decompose-multi-source-search-synthesize-cite fallback workflow when no specialist matches. Always surfaces the routing decision so users can override. Use when the user makes any research request that doesn't obviously match a more-specific specialist skill (e.g., \"research [topic]\", \"look into [topic]\", \"what do we know about [topic]\", \"investigate [topic]\", \"find me information on [topic]\", \"do some research on [topic]\", \"I need to understand [topic]\"). Output is a markdown briefing (default) or .docx document (on request) with full citations and an audit log.","https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE\u002Fblob\u002Fmain\u002Fskills-library\u002Fresearch\u002Fresearch\u002Fskills\u002Fresearch\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":18},"01M75RA8RK2JVWB8MYGRB65V75","pulse","Multi-source recency research skill that takes the pulse of any topic across Reddit, Hacker News, the open web, and optionally X\u002FTwitter within a configurable recent window (default 30 days). Forcing intake clarifies topic specificity, angle (trend\u002Fsentiment\u002Fproblems\u002Fopportunities\u002Fcomparison), time window, and platform scope before searching. Returns a synthesized briefing with citations, engagement metrics, and cross-platform pattern analysis. Use when the user requests multi-source recency intelligence on a topic (e.g., 'pulse on [topic]', 'what's happening with [topic]', 'what are people saying about [topic]', 'current conversation about [topic]', 'take the pulse of [topic]', 'trending: [topic]', 'find me info on [topic]'), and for competitor research, trend discovery, tool comparisons, and audience sentiment analysis.","https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE\u002Fblob\u002Fmain\u002Fskills-library\u002Fresearch\u002Fpulse\u002Fskills\u002Fpulse\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":18},"01M75RA08RXYRFSTNC6EEEX4ZD","patent","Patent prior-art and landscape intelligence skill — not generic patent help. Commits to one of five sub-use-cases via forcing intake (novelty search \u002F freedom-to-operate \u002F competitive landscape \u002F acquisition diligence \u002F litigation prior-art) before any search runs. Searches Google Patents, Espacenet, USPTO, and optionally Lens.org for citation-graph signals. Output is an editable Word document (.docx) with verdict, ranked closest art (claim-text extracted), CPC-class-aware landscape, family-resolved hits, geographic coverage, FTO flags where applicable, strategy recommendations, and full audit log. Use when the user asks for patent searching or analysis (e.g., 'prior art search for [invention]', 'freedom to operate analysis for [product]'). Produces search signal, not legal advice — always recommends consulting a patent attorney before filing or licensing decisions. Trademark, copyright, and trade-secret questions are out of scope.","https:\u002F\u002Fgithub.com\u002FTehutiRaEl\u002FTHEHIVE\u002Fblob\u002Fmain\u002Fskills-library\u002Fresearch\u002Fpatent\u002Fskills\u002Fpatent\u002FSKILL.md",[],[]]