Update environment catalog and task IDs

Synchronize the illustrated and generated environment documentation with registered tasks and preset selectors. Add Kit screenshots and canonical versionless IDs while preserving released names as deprecated aliases. Add developer guidance that keeps future catalog and documentation updates validated.

Author: kellyguo11

.agents/skills/isaaclab-updating-environment-docs

@@ -0,0 +1 @@
+../../skills/developer/isaaclab-updating-environment-docs

docs/source/_static/tasks/classic/fourbar_pole.jpg

@@ -87,7 +87,9 @@ def main():
     task_specs = [
         spec
         for spec in gym.registry.values()
-        if "Isaac" in spec.id and (args_cli.keyword is None or args_cli.keyword in spec.id)
+        if "Isaac" in spec.id
+        and not spec.kwargs.get("deprecated")
+        and (args_cli.keyword is None or args_cli.keyword in spec.id)
     ]
 
     if args_cli.show_presets:

docs/source/_static/tasks/locomotion/dr_legs.jpg

@@ -0,0 +1,56 @@
+---
+name: isaaclab-updating-environment-docs
+description: Keeps the illustrated environment catalog and generated comprehensive table synchronized with task registrations and preset selectors. Use when adding or renaming an Isaac Lab environment, changing its physics, renderer, or domain presets, or reviewing environment documentation completeness.
+audience: developer
+status: experimental
+owners:
+  - isaaclab-maintainers
+---
+
+# Updating Environment Documentation
+
+## When To Use
+
+Use this skill whenever a registered environment is added or renamed, or when its accepted ``physics=``, ``renderer=``, or ``presets=`` selectors change.
+
+## Workflow
+
+1. Read the task registration and configuration to identify its training ID, inference ID, workflow, RL-library entry points, and selectable presets. Use versionless ``Isaac-`` IDs for core tasks and versionless ``IsaacContrib-`` IDs for contributed tasks. Preserve released IDs as deprecated aliases when renaming is necessary. Distinguish selectable presets from fixed configuration: if a task supports only one hard-wired backend, leave its Presets cell empty instead of adding or documenting a single-option selector.
+2. Update the appropriate illustrated category table in ``docs/source/overview/environments.rst``. Add a concise description, exact selector groups, source-link substitutions, and a representative screenshot under ``docs/source/_static/tasks/`` when the world is new. Capture catalog screenshots with the Kit visualizer so their rendering matches the existing gallery unless the section deliberately documents another visualizer.
+3. Run the registry-backed updater:
+
+   ```bash
+   ./isaaclab.sh -p tools/update_environments_rst.py
+   ```
+
+   This rewrites the comprehensive table from the Gym registry and groups names under ``physics=``, ``renderer=``, and ``presets=``.
+4. Review the generated diff. Do not edit content between the comprehensive-list marker comments by hand.
+5. Confirm the illustrated table and comprehensive table both contain the task and agree with the task's accepted selectors.
+6. When the documentation update is part of a PR, build the docs and require a clean result. The docs target runs Sphinx with warnings treated as errors, so any warning or error must be resolved before publishing the PR.
+
+## Validation
+
+Run:
+
+```bash
+./isaaclab.sh -p tools/update_environments_rst.py --check
+./isaaclab.sh -p scripts/environments/list_envs.py --show_presets
+./isaaclab.sh -d
+./isaaclab.sh -p tools/skills/cli.py check
+```
+
+Require ``./isaaclab.sh -d`` to exit successfully with no warnings or errors. Inspect the compiled
+``docs/_build/current/source/overview/environments.html`` page and verify that every new image and
+substitution target renders correctly.
+
+## Maintenance
+
+Keep this workflow synchronized with the environment catalog markers, the registry collector, the preset CLI, and the environment-list script. When those tools change, update the source documentation behavior first and keep this skill as a concise routing checklist.
+
+## References
+
+- [Environment catalog](../../../docs/source/overview/environments.rst)
+- [Environment documentation collector](../../../tools/environ_docs.py)
+- [Environment documentation updater](../../../tools/update_environments_rst.py)
+- [Environment list script](../../../scripts/environments/list_envs.py)
+- [Preset CLI](../../../source/isaaclab_tasks/isaaclab_tasks/utils/preset_cli.py)

docs/source/_static/tasks/manipulation/franka_lift_cloth.jpg

@@ -0,0 +1,9 @@
+# Copyright (c) 2022-2026, The Isaac Lab Project Developers (https://github.com/isaac-sim/IsaacLab/blob/main/CONTRIBUTORS.md).
+# All rights reserved.
+#
+# SPDX-License-Identifier: BSD-3-Clause
+
+interface:
+  display_name: "Update Environment Docs"
+  short_description: "Keep environment catalog entries and presets current"
+  default_prompt: "Use $isaaclab-updating-environment-docs to update the environment catalog for a new or modified task."

docs/source/overview/environments.rst

@@ -21,11 +21,12 @@ Do not use this skill to bypass repository checks or to push to `origin`.
 2. Confirm the branch is focused on one logical change.
 3. Run targeted tests for the touched behavior.
 4. For skill changes, inspect the changed skill's adjacent `evaluations.md` when present, plus directly linked `examples.md` or `reference.md`, and confirm the representative scenarios still match the skill guidance.
-5. Run formatting and lint checks with `./isaaclab.sh -f`.
-6. Add package changelog fragments when `source/<package>/` code changes.
-7. Check whether `CONTRIBUTORS.md` needs an update for a new contributor.
-8. Draft a commit message in imperative mood with no AI attribution.
-9. Use the PR checklist in `.github/PULL_REQUEST_TEMPLATE.md`.
+5. If the PR changes documentation, run `./isaaclab.sh -d` and require a successful build with no warnings or errors. The docs target treats Sphinx warnings as errors.
+6. Run formatting and lint checks with `./isaaclab.sh -f`.
+7. Add package changelog fragments when `source/<package>/` code changes.
+8. Check whether `CONTRIBUTORS.md` needs an update for a new contributor.
+9. Draft a commit message in imperative mood with no AI attribution.
+10. Use the PR checklist in `.github/PULL_REQUEST_TEMPLATE.md`.
 
 ## Validation
 
@@ -41,6 +42,12 @@ For targeted tests, use:
 ./isaaclab.sh -p -m pytest PATH_TO_TEST
 ```
 
+If documentation changed, require a warning-free build:
+
+```bash
+./isaaclab.sh -d
+```
+
 If skills changed, run:
 
 ```bash

scripts/environments/list_envs.py

@@ -23,7 +23,7 @@ Input: a PR modifies `docs/source/overview/`.
 
 Expected workflow:
 
-1. Build or preview docs when the change affects rendering.
+1. Run `./isaaclab.sh -d` and require the build to complete without warnings or errors.
 2. Run `./isaaclab.sh -f`.
 3. Do not add a package changelog fragment unless `source/<package>/` changed.