git:20260307.388baa3 to git:20260316.e08426e
11 added, 5 removed. Audit A to A.
---
name: scienceworld-substance-preparator
- description: This skill transfers a target substance into an appropriate container for processing (e.g., a pot for heating, a beaker for mixing). It should be triggered after acquiring the substance and before setting up an apparatus. The skill selects a suitable empty container and moves the substance into it.
+ description: Use when you need to transfer a target substance into an appropriate container for processing (e.g., a pot for heating, a beaker for mixing). Trigger after acquiring the substance and before setting up an apparatus. Selects a suitable empty container and moves the substance into it.
---
# Substance Preparation Skill
## Purpose
Prepare a target substance for subsequent processing (e.g., heating, mixing) by transferring it from its current location into an appropriate, empty container.
## When to Use
1. **Trigger:** After successfully locating and focusing on the target substance.
2. **Prerequisite:** The substance must be accessible (e.g., in inventory, in an open container).
3. **Next Step:** This skill should be completed **before** setting up any apparatus (e.g., activating a stove, connecting electrical components).
## Core Procedure
1. **Identify Target Substance:** Confirm the exact name and location of the substance to be prepared.
2. **Scan Environment for Containers:** Look for empty, process-appropriate containers in the current room. Priority order:
* **Primary:** Metal pots, beakers, or bowls (for heating/mixing).
* **Secondary:** Ceramic/glass cups, jars (if primary not available).
* **Avoid:** Containers already holding items or substances.
3. **Select & Validate Container:** Choose the most suitable empty container. If uncertain, `examine` it to confirm it's empty.
4. **Execute Transfer:** Use the `move [SUBSTANCE] to [CONTAINER]` action.
5. **Verify:** Briefly check the container's contents to confirm the transfer was successful.
## Key Considerations
* **Container State:** All containers are pre-opened. Do not use `open` or `close` actions.
* **Efficiency:** Prefer containers in the same room to minimize `teleport` use.
* **Substance Integrity:** If the substance is temperature-sensitive (e.g., chocolate in a fridge), moving it to a room-temperature container is part of preparation.
* **Error Handling:** If the transfer fails (e.g., container not found), `look around` again and consult the bundled reference for common container names.
- ## Example from Trajectory
- > **Substance:** `chocolate` (found in fridge).
- > **Action:** `move chocolate to metal pot` (metal pot was empty in cupboard).
- > **Verification:** Subsequent `look at stove` showed "metal pot (containing chocolate)".
+ ## Example
+
+ **Scenario:** You need to melt chocolate as part of a heating task.
+
+ 1. You have already located `chocolate` in the `fridge` in the kitchen.
+ 2. Run `look around` to scan for containers. You see: `metal pot` (empty, on counter), `glass beaker` (empty, on shelf), `ceramic cup` (contains water).
+ 3. Select `metal pot` as the best option (metal, empty, suitable for heating).
+ 4. Run `examine metal pot` to confirm it is empty.
+ 5. Run `move chocolate to metal pot`.
+ 6. Run `examine metal pot` — output confirms: "metal pot (containing chocolate)".
**Proceed to the next skill (e.g., apparatus setup) only after this verification.**