orx-create

Agent Skills › alphaXiv/OpenResearch › orx-create

orx-create

GitHub

用于初始化实验项目并创建实验节点，支持导入仓库、设置运行命令及建立基线或分支关系。

agent-skills/orx-create/SKILL.md alphaXiv/OpenResearch

触发场景

初始化新项目创建实验节点

安装

npx skills add alphaXiv/OpenResearch --skill orx-create -g -y

更多选项

非标准路径

npx skills add https://github.com/alphaXiv/OpenResearch/tree/main/agent-skills/orx-create -g -y

不安装直接使用

npx skills use alphaXiv/OpenResearch@orx-create

指定 Agent (Claude Code)

npx skills add alphaXiv/OpenResearch --skill orx-create -a claude-code -g -y

安装 repo 全部 skill

npx skills add alphaXiv/OpenResearch --all -g -y

预览 repo 内 skill

npx skills add alphaXiv/OpenResearch --list

SKILL.md

Frontmatter

{
    "name": "orx-create",
    "description": "Initialize a project with `orx up` and add experiment nodes with `orx create-experiment`. Use when starting a project or experiment, when the tree is empty, or when choosing a baseline, parent, or run command."
}

Start a project

Run orx up, then use the dashboard to import an existing Git repository or create a new project. Optional GitHub publication is for collaboration and is not required for compute.

For an existing GitHub repository, clone it normally before importing it:

git clone https://github.com/<owner>/<repo>
orx up

Prefer an existing implementation over starting from a blank repository. For a paper, use orx paper <id> and the orx-lit-review retrieval workflow to find the authors' or best community implementation, clone it, then import that checkout in orx up.

Set the project's run command once before launching experiments:

orx project edit <localProjectId> --run-command '<command>'

Add an experiment node

orx create-experiment accepts project and experiment ids:

# First node in an empty project: the baseline root.
orx create-experiment <localProjectId> --title "Baseline"

# Child node branched from an existing experiment.
orx create-experiment <localProjectId> --title "Larger batch" \
  --parent <localExperimentId> \
  --description "Increase batch size and compare throughput and loss."

# Explicit additional root when the project already has one.
orx create-experiment <localProjectId> --title "Alternative baseline" --baseline

The first parentless node is the baseline. Later parentless nodes attach to the oldest root unless --baseline explicitly requests another root.
A child branches from its parent's Git branch and inherits its run command. Vary code or configuration on the child; keep the command fixed.
--description should state the concrete change and measurement the node owes.
Commit the node's branch before launching. Runs use an immutable archive of that local commit.