mc-observe-blocks_skill
- Python
9
GitHub Stars
2
Bundled Files
2 months ago
Catalog Refreshed
4 months ago
First Indexed
Readme & install
Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.
Installation
Preview and clipboard use veilstrat where the catalogue uses aiagentskills.
npx veilstrat add skill bdambrosio/cognitive_workbench --skill mc-observe-blocks- Skill.md3.1 KB
- tool.py24.9 KB
Overview
This skill inspects visible non-air blocks around the agent within a capped radius (default and max 7) and returns both a human-readable summary and a structured observation dictionary. It focuses on navigation-relevant information: pose, per-direction distances, support surfaces, clearance, nearby block list, geometric hints, and movement affordances. It does not report dropped item entities.
How this skill works
The skill performs a cone-limited scan (120° horizontal, +60° up, -90° down) and applies short vertical probes to infer support surfaces and walkability. Results are filtered by a line-of-sight model tuned for navigation (non-supporting cover does not obscure potential support). Output includes a multi-line SUMMARY and a machine-readable data object with pose, per-direction block info, support estimates, clearance checks, nearby raw block entries, navigation surface samples, geometry flags, affordances, and a confidence level.
When to use it
- Planning short-range movement or path steps near the agent
- Assessing whether the block in front provides safe footing or an obstacle
- Detecting nearby hazards, fluids, or low-clearance passages
- Sampling surrounding surfaces for navigation or AI locomotion logic
- Quick situational checks before jumping, stepping, or descending
Best practices
- Keep radius at or below 7 (default) — the skill caps at 7 for consistent performance
- Use support.here and support.fwd to decide safe footsteps or next-position targets
- Combine with mc-observe-items when you need dropped item entities (this tool omits items)
- Retry or increase sensing frequency if conf == "low" to recover missing data
- Prefer the structured data.blocks.nearby for exact positions and the SUMMARY for quick human inspection
Example use cases
- Agent checking forward cell for a safe step and required jump height before moving
- Navigation system sampling nearby cells to build walkable surface candidates
- AI deciding whether to crouch or skip a low-clearance tunnel using clear and geom flags
- Safety check to detect nearby fluids or hazards and avoid stepping into them
- Generating a short human-readable situational SUMMARY for debugging or logging
FAQ
No. This tool only reports blocks. Use mc-observe-items to list dropped item entities.
What does conf mean?
conf indicates observation completeness: "high" = complete and fast, "med" = complete but slower, "low" = incomplete and may require retrying or different sensing parameters.
How is support determined?
Support is inferred by short vertical probes and a navigation-first cell scan that estimates support_y, support_block, and walkability for nearby cells; support.here and support.fwd summarize footing for current and forward positions.
