Guide · Open source
How to use AI-Research-SKILLs: install and run it with your coding agent
Updated · written with AI from the project's own documentation and checked against our catalogue data
AI-Research-SKILLs is an open-source (MIT licensed) library of 98 packaged skills, grouped into 23 categories, that you load into an AI coding agent such as Claude Code, Codex or Gemini CLI. Each skill gives the agent guidance on a specific ML framework or workflow, such as vLLM, TRL or Megatron-LM. This guide shows you how to install the skills, check and update them, and point your agent at them.
Quick start
- 1Check prerequisites. Confirm Node.js is installed and that you have an AI coding agent such as Claude Code, Codex or Gemini CLI.
- 2Run the interactive installer. Run npx @orchestra-research/ai-research-skills and choose what to install, or the quickstart bundle.
- 3Confirm the install. Run the list command to see which skills are installed.
- 4Keep skills current. Run the update command periodically to get the latest versions of installed skills.
- 5Load the skills into your agent. Let your agent detect the installed skills, or give it the welcome document URL so it follows the install steps.
- 6Try a framework task. Ask your agent a concrete ML task that matches a skill, such as serving a model with vLLM or fine-tuning with TRL.
What you need before installing
The skills are meant to be loaded into an AI coding agent, so you need one installed. The README names Claude Code, Codex and Gemini CLI as examples. The installer also detects other agents, including Hermes Agent, OpenCode, Qoder and Cursor.
The installer runs through npx, so you need Node.js. The README does not state a minimum Node.js version. The skills also assume you already have Python and ML environments set up.
- Node.js (required for npx)
- An AI coding agent such as Claude Code, Codex or Gemini CLI
- Python and ML environment experience (the skills assume it)
Install the skills with the interactive installer
The README recommends the interactive installer. Run it once and it walks you through choosing what to install.
The installer auto-detects coding agents on your machine, installs skills to ~/.orchestra/skills/ and creates symlinks to each agent. On Windows it falls back to copying files. You can install everything, the quickstart bundle, skills by category, or individual skills.
npx @orchestra-research/ai-research-skillsList and update installed skills
Once installed, you can check what is present and pull newer versions with two direct commands. The installer also supports uninstalling all skills or selected ones.
- list: shows installed skills
- update: updates installed skills to the latest versions
npx @orchestra-research/ai-research-skills list
npx @orchestra-research/ai-research-skills updateStart your agent with the autoresearch skill
The README says the autoresearch skill is the central orchestration layer. It uses a two-loop architecture (inner optimization and outer synthesis) and routes to the domain skills as needed. For agents, the README suggests giving the agent this instruction: read the welcome document at the URL below and follow it to install and use the skills.
Note that the README describes the goal of autonomous research from idea to paper but does not report how well this works.
- Welcome doc for agents: https://www.orchestra-research.com/ai-research-skills/welcome.md
Read https://www.orchestra-research.com/ai-research-skills/welcome.md and follow the instructions to install and use AI Research Skills.Install through the Claude Code marketplace instead
If you use Claude Code, the README also lists a marketplace route. You add the marketplace once, then install a single category, for example fine-tuning, post-training, inference-serving, distributed-training or optimization.
- fine-tuning covers Axolotl, LLaMA-Factory, PEFT and Unsloth
- post-training covers TRL, GRPO, OpenRLHF, SimPO, verl, slime, miles and torchforge
- inference-serving covers vLLM, TensorRT-LLM, llama.cpp and SGLang
/plugin marketplace add orchestra-research/AI-research-SKILLs
/plugin install fine-tuning@ai-research-skillsFind the right category for your task
The 23 categories cover the research lifecycle, including ideation, ML paper writing, model architecture, fine-tuning, post-training, distributed training, inference, evaluation, safety, RAG, multimodal and observability. Browse the category table to see which framework skills exist before you ask your agent for help.
Each skill has a linked folder in the repository with its own guidance. The README gives line counts and reference counts for each skill, which helps you judge how much material it contains.
- Use the table to find a framework by task, such as vLLM for serving or LoRA-style tools like PEFT for tuning
- Pick a narrow category if you only need one area, to keep the installed set small
What people use it for
- Asking Claude Code to set up a fine-tuning run with a library such as Axolotl or PEFT
- Having a coding agent write serving configuration for vLLM or SGLang
- Using the evaluation skills, such as lm-eval-harness, to set up model benchmarks
- Using the ML paper writing skill for LaTeX templates and citation verification
- Reading the category list as a structured reference of ML frameworks for coursework
Frequently asked questions
Is AI-Research-SKILLs free?
The repository is released under the MIT licence, as shown in its README badge and metadata. The README does not mention paid tiers, so check the licence file in the repository for the exact terms.
Do I need a coding agent to use it?
Yes. The skills are meant to be loaded into an agent such as Claude Code, Codex or Gemini CLI. The README does not describe using them without one.
What do I need installed first?
You need Node.js for npx and an AI coding agent. The skills also assume you already know Python and have ML environments set up.
How do I update the skills?
Run npx @orchestra-research/ai-research-skills update. This updates installed skills to their latest versions.
Can the agent really do research from idea to paper on its own?
The README states this as the goal, with the autoresearch skill orchestrating the workflow. It does not provide an evaluation of how well it performs, so treat autonomous paper writing as unproven and review all output.
Are there alternatives?
The source does not name comparable projects. Individual frameworks in the library, such as vLLM or TRL, are tools you can use directly without the skills.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
AI-Research-SKILLs suits developers and researchers who already use Claude Code, Codex or Gemini CLI and want the agent to know common ML frameworks and workflows. It is less useful if you have no coding agent or no Python and ML setup, and if you expect guaranteed autonomous paper writing, since the README does not show how well that works.
Install options & downloads