inno-prepare-resources

Files (1)

• SKILL.md

SKILL.md (first lines)

# inno-prepare-resources

## Canonical Summary

Loads the evaluation instance, searches GitHub for related repositories, builds a dataset description, queries the Prepare Agent for reference codebases, and downloads arXiv paper sources. Covers both Idea mode and Plan mode (the only diff...

## Trigger Rules

Use this skill when the user request matches its research workflow scope. Prefer the bundled resources instead of recreating templates or reference material. Keep outputs traceable to project files, citations, scripts, or upstream evidence.

## Resource Use Rules

- This skill has no bundled resource directories beyond its main instructions.

## Execution Contract

- Resolve every relative path from this skill directory first.
- Prefer inspection before mutation when invoking bundled scripts.
- If a required runtime, CLI, credential, or API is unavailable, explain the blocker and continue with the best manual fallback instead of silently skipping the step.
- Do not write generated artifacts back into the skill directory; save them inside the active project workspace.

## Upstream Instructions

# Inno Prepare Resources

## Inputs

Read from **`instance.json`**. Path values are **absolute** when the project is created by Dr. Claw; use as-is. If relative (e.g. hand-edited), resolve with `path.join(project_path, value)`.

| Parameter              | Required | Description |
|------------------------|----------|-------------|
| `instance`             | Yes      | Path to the instance JSON file (absolute in Dr. Claw). Use as-is to read the file. File contains `source_papers`, `task1`/`task2`, etc. |
| `task_level`           | Yes      | Which task field to read from the instance — `"task1"` (Plan) or `"task2"` (Idea) |
| `Ideation.references`  | Yes      | Path to Ideation references dir (absolute in Dr. Claw) — for downloaded papers and prepare logs |
| `Experiment.code_references` | Yes | Path (absolute in Dr. Claw) — for cloned repos |
| `Experiment.datasets`  | Yes      | Path (absolute in Dr. Claw) — for dataset files |
| `category`             | Yes      | Research category tag (e.g. `nlp_qa`, `gnn`, `recommendation`). Used to locate the built-in dataset metaprompt |
| `references`           | Yes      | A pre-formatted string listing all source papers from the instance |
| `context_variables`    | Yes      | Shared context dictionary; this step will write `date_limit` into it |
| `ideas`                | No       | Full innovative-idea / plan text. **Provide only in Plan mode** — when present the Prepare Agent query includes the ideas for more targeted repo selection |
| `dataset_description`   | No       | Pre-built dataset description from the orchestrator (for custom / user-provided datasets). When provided, skip the metaprompt import in Step 3 |

## Outputs

| Output                 | Description |
|------------------------|-------------|
| `prepare_res`          | Full text response from the Prepare Agent (contains selected reference repositories and reasoning) |
| `download_res`         | Result log from downloading arXiv paper sources to local disk |
| `dataset_description`  | Composed prompt string describing the datasets, baselines, comparisons, and evaluation metrics |
| `data_module`          | The imported metaprompt module object (Idea mode). In Plan mode this is not returned |
| `context_variables`    | Updated with `date_limit` (str, YYYY-MM-DD) |

## Cache file outputs

Every intermediate result must be persisted as a JSON file under `Ideation/references/logs/`. The directory layout follows:

```
Ideation/references/logs/
├── load_instance.json                  ← written by orchestrator
├── github_search.json
├── download_arxiv_source_by_title.json
└── prepare_agent.json
```

> `Ideation/references/logs/load_instance.json` is written by the **orchestrator** before this skill runs — do not overwrite it.

### Tool cache format (`tools/*.json`)

Each tool output file records the function call arguments and result:

```json
{
  "name": "<tool_name>",
  "args": { ... },
  "result": <result_value>
}
```

**`github_search.json`** — written after Step 2:

```json
{
  "name": "github_search",
  "args": {
    "metadata": {
      "source_papers": [ ... ],
      "task_instructions": "...",
      "date_limit": "YYYY-MM-DD"
    }
  },
  "result": "<concatenated github_result string>"
}
```

**`download_arxiv_source_by_title.json`** — written after Step 6:

```json
{
  "name": "download_arxiv_source_by_title",
  "args": {
    "paper_list": ["paper title 1", "paper title 2"],
    "references_path": "<instance.Ideation.references if absolute, else path.join(project_path, instance.Ideation.references)>"
  },
  "result": "<download result log string>"
}
```

### Agent cache format (`agents/*.json`)

Each agent output file records the final context variables (no conversation messages):

```json
{
  "context_variables": {
    "references_path": "<use instance.Ideation.references as-is if absolute, else path.join(project_path, ...)>",
    "code_references_path": "<use instance.Experiment.code_references as-is if absolute, else path.join(project_path, ...)>",
    "datasets_path": "<use instance.Experiment.datasets as-is if absolute, else path.join(project_path, ...)>",
    "date_limit": "YYYY-MM-DD",
    "prepare_result": {

From LigphiDonk/Oh-my--paper, MIT.

More from LigphiDonk/Oh-my--paper