Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions .agents/plugins/marketplace.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"name": "ml-energy-data",
"interface": {
"displayName": "ML.ENERGY Data"
},
"plugins": [
{
"name": "skill",
"source": {
"source": "local",
"path": "./."
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Coding"
}
]
}
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
"name": "Jae-Won Chung",
"email": "jwnchung@umich.edu"
},
"description": "ML.ENERGY Data Toolkit plugins for Claude Code.",
"description": "ML.ENERGY Data Toolkit plugins for AI coding agents.",
"plugins": [
{
"name": "skill",
Expand Down
30 changes: 30 additions & 0 deletions .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
{
"name": "skill",
"description": "Analyze The ML.ENERGY Benchmark data with the mlenergy-data Python toolkit.",
"author": {
"name": "Jae-Won Chung",
"email": "jwnchung@umich.edu"
},
"homepage": "https://ml.energy/data",
"repository": "https://github.com/ml-energy/data",
"license": "Apache-2.0",
"keywords": [
"ml-energy",
"benchmark",
"gpu",
"energy",
"inference"
],
"skills": "./skills/",
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The path to the skills directory is likely incorrect. Since this manifest is located within the .codex-plugin/ subdirectory, the relative path to the skills/ directory at the repository root should be ../skills/. Using ./skills/ would cause the tool to look for a skills/ folder inside .codex-plugin/, which does not exist.

Suggested change
"skills": "./skills/",
"skills": "../skills/",

"interface": {
"displayName": "ML.ENERGY Data",
"shortDescription": "Analyze ML inference energy benchmark data",
"longDescription": "Use the mlenergy-data Python toolkit to query and compare LLM and diffusion inference energy, latency, throughput, and power measurements on H100 and B200 GPUs.",
"developerName": "ML.ENERGY",
"category": "Coding",
"capabilities": [
"Interactive"
],
"websiteURL": "https://ml.energy/data"
}
}
20 changes: 14 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,20 +69,28 @@ for arch, group in runs.task("gpqa").gpu_model("B200").group_by("architecture").
For Claude Code, install via the bundled plugin marketplace:

```
# Inside Claude Code
/plugin marketplace add ml-energy/data
/plugin install skill@ml-energy-data
```

For other tools, drop the skill directly into that tool's skills directory:
For Codex, add the marketplace from your shell:

```bash
# or ~/.config/goose/skills, ~/.gemini/skills, ~/.claude/skills, ...
mkdir -p ~/.cursor/skills && \
curl -fsSL https://github.com/ml-energy/data/archive/refs/heads/master.tar.gz | \
tar -xz -C ~/.cursor/skills --strip-components=2 'data-master/skills/mlenergy-data'
codex plugin marketplace add ml-energy/data
```

Gemini CLI also supports `gemini skills install https://github.com/ml-energy/data --consent --scope user` directly.
Then install the plugin from inside Codex:

```text
/plugins
```

In the plugin browser, select the `ml-energy-data` marketplace and install `skill`.

Gemini CLI also supports `gemini skills install https://github.com/ml-energy/data --path skills`.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The path provided for the Gemini CLI installation is likely too broad. The actual skill definition is located in skills/mlenergy-data/. Providing only --path skills might fail if the tool expects the direct path to the directory containing the SKILL.md file. It is safer to point directly to the specific skill folder.

Suggested change
Gemini CLI also supports `gemini skills install https://github.com/ml-energy/data --path skills`.
Gemini CLI also supports `gemini skills install https://github.com/ml-energy/data --path skills/mlenergy-data`.


For other tools, you can download the `skills/` directory and place it in the appropriate skills directory.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The instruction to download the skills/ directory is ambiguous. If a user places the entire skills/ directory into their tool's skills folder, it will create a nested structure (e.g., ~/.cursor/skills/skills/mlenergy-data/), which most tools will not recognize. It is better to specify that the mlenergy-data subdirectory should be used.

Suggested change
For other tools, you can download the `skills/` directory and place it in the appropriate skills directory.
For other tools, you can download the `skills/mlenergy-data` directory and place it in the appropriate skills directory.


## Documentation

Expand Down