loc-iterate

Runs one supervised iteration cycle on a locbench localization candidate.

1|1|Updated Nov 28, 2025
One-click install
npx skills add https://github.com/33may/robotics --skill loc-iterate-33may
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: loc-iterate
Source: https://github.com/33may/robotics/tree/main/humanoid/.claude/skills/loc-iterate
Command: npx skills add https://github.com/33may/robotics --skill loc-iterate-33may

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developing a robot localization module requires disciplined, one-change-at-a-time iteration with benchmark evidence, but ad-hoc tuning loses causal traceability and risks corrupting the evaluation oracle. This Skill enforces a structured pair-mode development cycle so every change is hypothesized, smoke-tested, analyzed from plots, and journaled. ## Core Features & Use Cases - Resume-safe orientation: Reconstructs candidate state purely from disk (README, JOURNAL tail, latest run report) so a killed session can be picked up without prior context. - Single-change discipline: Proposes exactly one config value or code fix per cycle, runs the locbench smoke grind, and analyzes report.json plus trajectory plots to name the failure mode. - Human decision gate: Stops at the improve/pivot/abandon verdict for the human operator, then journals the decision and commits one iteration per commit. - Use Case: A robotics engineer says "iterate rtabmap" to run one full benchmark cycle on the rtabmap localization candidate, getting a smoke-run report, plot-based failure analysis, and a journaled decision. ## Quick Start Ask the assistant to run a loc-iterate cycle on an existing localization candidate, for example by saying "iterate rtabmap" or "run a locbench cycle on <name>".

Frequently Asked Questions about loc-iterate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I iterate on a robot localization module with a benchmark?

Run one cycle per change: orient from the candidate's README and journal, propose a single config or code change, execute the locbench smoke run, then analyze report.json and trajectory plots. Journal the hypothesis, result, and decision before committing.

How to run a locbench smoke test for a localization candidate?

Run the smoke grind with the module's run command using the --smoke flag, which boots the world, brain environment, and evaluator as one subprocess. The exit code is the verdict and artifacts land in a fresh run directory with report.json and plots.

What is the difference between bring-up and tuning phases in localization development?

Bring-up applies when the candidate has never completed a smoke episode without crashing, so accuracy gates are ignored and the goal is simply running at all. Tuning begins once episodes complete, and work targets the accuracy gates measured in report.json.

Why should only one change be made per benchmark iteration?

One change per iteration keeps the journal causally readable, so each result can be attributed to exactly one hypothesis. Mixing config and code changes in a single run makes it impossible to know what moved the metric.

Can I adjust benchmark gate thresholds to make a localization candidate pass?

No. Editing the benchmark harness, gate thresholds, or episode definitions to force a pass violates oracle integrity. If a gate seems wrong, journal the concern and pause for the human operator instead of acting.

Does a smoke test pass mean the localization candidate is certified?

No. A smoke pass means nothing until the full benchmark set confirms it. On a smoke pass, propose the full run without the smoke flag before making any tier claim or leaderboard entry.