# Alfworld Receptacle Finder

Searches for a suitable empty or appropriately occupied receptacle (like a shelf or...

- Repository: https://github.com/zjunlp/SkillNet (1441 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-13
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add zjunlp/SkillNet --skill alfworld-receptacle-finder -g -a claude-code -y`
Codex: `npx skills add zjunlp/SkillNet --skill alfworld-receptacle-finder -g -a codex -y`
Cursor: `npx skills add zjunlp/SkillNet --skill alfworld-receptacle-finder -g -a cursor -y`
Gemini CLI: `npx skills add zjunlp/SkillNet --skill alfworld-receptacle-finder -g -a gemini-cli -y`

## Description

Searches for a suitable empty or appropriately occupied receptacle (like a shelf or table) to place an object. Use when you are holding an object that needs to be stored or placed and must find a receptacle that meets the placement criteria. Examines candidate receptacles by navigating to and inspecting each one until a suitable location is found.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Instructions

**Trigger:** Use this skill when you have an object in your inventory that needs to be stored or placed, and you must find a suitable receptacle (e.g., shelf, table, basin).

## Core Procedure
1.  **Identify Target Object:** Confirm the object you are holding and its state (e.g., `soapbar 1`, `clean`).
2.  **Survey Environment:** Use `go to {recep}` actions to navigate to and visually inspect candidate receptacles from the observation list.
3.  **Evaluate Candidates:** For each receptacle, assess its suitability:
    *   **Primary Goal:** Find an **empty receptacle**.
    *   **Fallback:** If no empty receptacle is available, identify one that can logically accommodate the object without conflict (e.g., a shelf with a tissuebox may still have space for a soapbar).
4.  **Select & Place:** Navigate to the chosen suitable receptacle and execute `put {obj} in/on {recep}`.

## Key Considerations
*   **Object State:** Ensure the object meets any required pre-conditions (e.g., `clean`) before searching for a receptacle. Use skills like `clean` if necessary.
*   **Efficiency:** Prioritize receptacles that are logically appropriate for the object (e.g., a `shelf` for a `soapbar` over a `toilet`).
*   **Observation Parsing:** Carefully read the observation after each `go to` action. The line "On the {recep}, you see..." lists its contents. "you see nothing." indicates it is empty.
*   **Invalid Actions:** If an action fails ("Nothing happened"), re-evaluate your target and try a different receptacle or confirm the object is in your inventory.

## Example

**Scenario:** You are holding `soapbar 1` (clean) and need to find an empty shelf to place it.

The rest: https://github.com/zjunlp/SkillNet/blob/HEAD/experiments/src/skills/alfworld/alfworld-receptacle-finder/SKILL.md