alfworld-tool-user
$
npx mdskill add zjunlp/SkillNet/alfworld-tool-userExecute tool interactions on ALFWorld objects to complete tasks.
- Enables agents to perform actions like cleaning, heating, or cooling.
- Depends on ALFWorld environment state and object locations.
- Determines correct verbs by parsing task requirements and context.
- Outputs precise action commands for the environment to execute.
SKILL.md
.github/skills/alfworld-tool-userView on GitHub ↗
---
name: alfworld-tool-user
description: Use when the agent needs to apply a tool to a target object in ALFWorld to accomplish an interaction such as cleaning, heating, cooling, or examining. This skill handles locating both the tool and target object, then executing the correct environment action (e.g., `clean`, `heat`, `cool`, `use`) to progress the task.
---
# Skill: Tool User for ALFWorld
## When to Use
Trigger this skill when:
1. A task requires applying a tool to an object (e.g., cleaning a knife with a sinkbasin, heating food with a microwave)
2. Both the tool and target object are in the agent's possession or within reach
3. The agent knows which interaction verb to use for the task context
## Core Workflow
### 1. Identify Requirements
- Parse the task to determine:
- **Target object**: The item to be acted upon (e.g., `knife 1`, `potato 2`)
- **Required tool**: The appliance or instrument needed (e.g., `sinkbasin 1`, `microwave 1`)
- **Interaction type**: The action verb (`clean`, `heat`, `cool`, `use`, `examine`)
### 2. Locate and Acquire
- **Target object**: If not in inventory, navigate to its location and `take {object} from {receptacle}`
- **Tool**: Navigate to the tool's location (tools are typically stationary appliances)
### 3. Execute Interaction
Apply the tool to the object using the correct action syntax:
| Interaction | Action Command | Example |
|-------------|---------------|---------|
| Clean | `clean {obj} with {tool}` | `clean knife 1 with sinkbasin 1` |
| Heat | `heat {obj} with {tool}` | `heat potato 2 with microwave 1` |
| Cool | `cool {obj} with {tool}` | `cool apple 1 with fridge 1` |
| Examine | `examine {obj}` | `examine book 3` |
| Use | `use {tool}` | `use desklamp 1` |
### 4. Verify Outcome
- Check the environment observation after the action
- A successful interaction changes the object state (e.g., `knife 1` becomes clean)
- If the observation says "Nothing happened," the action was invalid
## Error Handling
- **"Nothing happened"**: Reassess whether the agent is at the correct location and holding the correct object. Verify the action verb matches the task context.
- **Wrong tool**: If the tool does not match the interaction type, search for the correct appliance (e.g., use `sinkbasin` for cleaning, not `bathtub`).
- **Object not held**: The agent must be holding the target object before most interactions. Use `take` first.
## Example
**Task:** "Clean the knife and put it in the drawer."
```
> go to countertop 1
On the countertop 1, you see a knife 1, a saltshaker 2.
> take knife 1 from countertop 1
You pick up the knife 1 from the countertop 1.
> go to sinkbasin 1
On the sinkbasin 1, you see nothing.
> clean knife 1 with sinkbasin 1
You clean the knife 1 using the sinkbasin 1.
```
**Result:** `knife 1` is now clean and ready for the next step (storing).
More from zjunlp/SkillNet
- alfworld-appliance-navigatorNavigates the agent to a target appliance (microwave, stove, fridge, or sinkbasin) needed for object processing. Use when you are holding an object that needs heating, cooling, or cleaning and must move to the correct appliance station. Identifies the required appliance from the task context and executes the movement action.
- alfworld-appliance-preparerPrepares a household appliance (microwave, oven, toaster, fridge) for use by ensuring it is in the correct open/closed state. Use when the agent needs to heat, cool, or cook an item and must first open or close the appliance before placing an object inside. Takes an appliance identifier as input and outputs a confirmation that the appliance is ready for the next action.
- alfworld-clean-objectCleans a specified object using an appropriate cleaning receptacle (e.g., sinkbasin). Use when a task requires an object to be in a clean state (e.g., "clean potato", "wash apple") before proceeding. Navigates to the cleaning location, performs the clean action, and confirms the object is now clean.
- alfworld-device-operatorOperates a device or appliance (like a desklamp, microwave, or fridge) to interact with another object. Use when the task requires using a tool on a target item (e.g., "look at laptop under the desklamp", "heat potato with microwave"). Locates both the device and target object, co-locates them, and executes the appropriate use action (toggle, heat, cool, or clean).
- alfworld-environment-scannerPerforms an initial scan of the ALFWorld environment to identify all visible objects and receptacles. Use when you first enter an environment and need to build a mental map for task planning. Processes raw observation text into a structured list of entities, categorizing them as objects or receptacles.
- alfworld-goal-interpreterParses the natural language task goal to extract actionable sub-objectives and required objects. Trigger this skill whenever a new task is assigned to break down complex instructions into clear, sequential targets. It interprets phrases like 'look at X under Y' to identify target objects (pillow), reference objects (desklamp), and spatial relationships (under).
- alfworld-heat-object-with-applianceUses a heating appliance (microwave, stoveburner, oven) to apply heat to a specified object. Use when the task requires warming or cooking an item (e.g., "heat some egg", "warm the mug") and a heating appliance is available. Takes the object name and appliance name as input and outputs the object in a heated state, ready for placement at the task's target location.
- alfworld-inventory-managementUse when the agent must collect and track multiple instances of the same object type in ALFWorld (e.g., "put two cellphone in bed"). This skill maintains a count of collected versus needed objects, guides systematic searching through receptacles, and ensures each found object is placed at the target before searching for the next.
- alfworld-locate-target-objectNavigates to a suspected location and identifies a target object. Use when your goal requires finding a specific object (e.g., "potato", "plate") and its location is not immediately known. Moves to a relevant receptacle (like a fridge or cabinet), checks its contents, and outputs the object's location or confirms its absence.
- alfworld-location-navigatorMoves the agent to a specified receptacle or object location within the Alfworld environment. Use this skill when the agent needs to physically approach a target to inspect or interact with it, such as when checking an object's state or preparing for pickup. The skill takes a target location name as input and executes the 'go to' action, resulting in the agent being positioned at the destination for subsequent operations.