.cortex/skills/routing-customization/read-ors-configuration/SKILL.md
Subskill of routing-customization. Read current OpenRouteService configuration (region and routing profiles) and display to the user. Use when: checking current ORS settings, verifying map region, listing enabled vehicle profiles. Do NOT use for: changing configuration (use routing-customization), deploying demos, or building ORS from scratch. Triggers: ors configuration, openrouteservice config, routing simulator configuration, current map, current location, current vehicle types, current routing profiles.
npx skillsauth add snowflake-labs/sfguide-create-a-route-optimisation-and-vehicle-route-plan-simulator read-ors-configurationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Detects the map region/location and routing profiles from the ORS configuration and displays them to the user.
<REGION_NAME>: The configured region name<ENABLED_PROFILES>: List of enabled vehicle profilesFollow the Error Logging convention in AGENTS.md. Log file prefix:
routing-customization.
Goal: Determine the currently configured map region
Actions:
DESCRIBE SERVICE OPENROUTESERVICE_NATIVE_APP.CORE.ORS_SERVICE;
<REGION_NAME> for the service: /home/ors/files/<REGION_NAME>.osm.pbf<REGION_NAME> (e.g., "SanFrancisco", "great-britain-latest", "paris")Output: <REGION_NAME> extracted
Goal: Determine which vehicle profiles are currently enabled
Actions:
Download the ORS config file from stage:
snow stage copy @OPENROUTESERVICE_NATIVE_APP.CORE.ORS_SPCS_STAGE/<REGION_NAME>/ors-config.yml .cortex/skills/build-routing-solution/native_app/provider_setup/staged_files/ --connection <ACTIVE_CONNECTION> --overwrite
Read .cortex/skills/build-routing-solution/native_app/provider_setup/staged_files/ors-config.yml
Parse the downloaded file for profiles: entries with enabled: true
driving-car, driving-hgv, cycling-electric, cycling-regular, foot-walkingOutput: <ENABLED_PROFILES> extracted
Goal: Present the current ORS configuration
Actions:
<REGION_NAME><ENABLED_PROFILES>Output: ORS configuration displayed to the user
| Issue | Solution |
|-------|----------|
| DESCRIBE SERVICE fails | ORS Native App not installed or service not created. Install via build-routing-solution skill |
| Config file download fails | Service may be running with default config. Check stage path matches <REGION_NAME> from Step 1 |
| No profiles found in config | Config file may be malformed. Check ors.engine.profiles section exists in the YAML |
tools
Optimize, audit, create, and improve Cortex Code skills following official best practices from the Anthropic skill-building guide. Use when: creating a new skill, reviewing an existing skill, optimizing skill description or triggers, improving SKILL.md structure, auditing skill quality, fixing undertriggering or overtriggering, restructuring skill for progressive disclosure. Do NOT use for: general code review, non-skill markdown editing, MCP server development. Triggers: optimize skill, audit skill, review skill, create skill, improve skill, fix skill triggers, skill best practices, skill quality check.
testing
Discover and remove all Snowflake objects created by skills in this repo. Uses the COMMENT tracking tag (sf_sit-is-fleet) to find objects, generates DROP statements, and optionally executes them. Use when: cleaning up after a demo, removing all skill-created objects, tearing down an environment, uninstalling a specific skill's objects. Do NOT use for: dropping objects not created by these skills, production environment cleanup without review. Triggers: routing-solution-cleanup, cleanup, teardown, remove, uninstall, drop all, clean up demo, remove skill objects, reset environment.
tools
Check and install build prerequisites for the Routing Solution project. Use when: verifying environment setup before building, checking if Docker/Podman/snow CLI are installed, confirming readiness to build. Do NOT use for: building the routing solution itself (use build-routing-solution), deploying demos, or changing ORS configuration. Triggers: check prerequisites, check build prerequisites, am I ready to build, what do I need installed, verify environment setup, Docker installed, Podman installed, snow CLI installed.
tools
Enable or disable ORS routing profiles (driving-car, driving-hgv, cycling, walking, wheelchair). Subskill of routing-customization — must be invoked from the router, not independently. Use when: changing vehicle types as part of customization workflow. Do NOT use for: standalone execution, changing map region, or deploying demo apps. Triggers: change routing profile, change vehicle type, enable profile, disable profile.