major-ai-skills/skills/arcgis-pro/gemini.md

Installable agentic skills / AI agent skills (SKILL.md) for Claude Code, Cursor, Codex CLI, Gemini CLI & Antigravity - 402+ professional app, token-efficiency, and common-sense skills. SEO/GEO ready.

---

title: "Esri ArcGIS Pro Enterprise GIS AI Skill Guide (Gemini)"
description: "Comprehensive operational skill specification for Google Gemini to visually diagnose, automate, script, and troubleshoot ArcGIS Pro map layouts, Symbology classifications, 3D Local Scene terrains, and ModelBuilder graphs."
category: "Enterprise Geospatial Analysis & Mapping"
tags: ["arcgis-pro", "cartography", "symbology", "gemini", "3d-scenes", "modelbuilder"]
---


# Esri ArcGIS Pro Enterprise GIS AI Skill Guide (Gemini)

## Overview & Engine Architecture
ArcGIS Pro delivers enterprise spatial analytics, photorealistic 3D terrain modeling, dynamic thematic cartography, and visual geoprocessing pipelines in **ModelBuilder**. Gemini acts as an AI GIS Analyst and Cartographic Reviewer, specializing in **multimodal Map Layout inspection**, **thematic Symbology classification validation (Quantile, Natural Breaks / Jenks, Equal Interval)**, **3D Local/Global Scene elevation mesh analysis**, and **ModelBuilder workflow triage**.

### Visual Analytics & Spatial Modeling Stack

```
┌─────────────────────────────────────────────────────────────┐
│                 ArcGIS Pro Visual Operations                │
│                                                             │
│  2D / 3D Cartographic Presentation                          │
│  ├── 2D Map Canvas (Vector Symbology, Dynamic Labeling)     │
│  ├── 3D Local/Global Scenes (TIN, Lidar LAS Point Clouds)   │
│  └── Publication Layouts (North Arrows, Dynamic Legends)    │
│                                                             │
│  Thematic & Visual Workflow Engine                          │
│  ├── Symbology Engine (Graduated Colors, Unclassed, Dot)    │
│  ├── ModelBuilder (Visual Model Iterator & Tool Connector)  │
│  └── Imagery & Raster Functions (NDVI, Hillshade, Slope)    │
└─────────────────────────────────────────────────────────────┘
```

---


## Operational Capabilities & Agent Directives

1. **Multimodal Map Layout & Cartography Triage**: Evaluate screenshots of ArcGIS Pro publication layouts to identify dynamic text clipping, legend symbol overlap, scale bar division mismatches, and poor color contrast ratios (ColorBrewer compliance).
2. **Thematic Symbology Optimization**: Select appropriate statistical data classification methods (Jenks Natural Breaks for skewed data vs Equal Interval for standard continuous ranges) to avoid cartographic misrepresentation.
3. **3D Scene & Elevation Diagnostics**: Troubleshoot floating or sunken 3D building multipatches, subsurface terrain clipping, and Lidar LAS dataset elevation classification tags.
4. **ModelBuilder Workflow Debugging**: Inspect visual ModelBuilder graphs to diagnose broken data links (blue oval inputs $\rightarrow$ yellow rectangle tools $\rightarrow$ green oval outputs) and precondition blockers.

---


## Production Python Automation: Automated PDF Map Series Exporter (`arcpy.mp`)

Run this script to iterate through an ArcGIS Pro Map Series layout and export individual high-resolution GeoTIFF / PDF plates:

```python
"""
ArcGIS Pro Layout Automation (arcpy.mp)
Iterates across a Map Series layout and exports high-resolution PDFs.
"""

import sys
import os
import arcpy

def export_map_series(aprx_path: str, layout_name: str, output_pdf: str):
    if not os.path.exists(aprx_path):
        print(f"Error: ArcGIS Pro project '{aprx_path}' not found.")
        return

    print(f"Loading ArcGIS Pro Project: {aprx_path}...")
    aprx = arcpy.mp.ArcGISProject(aprx_path)
    layout = aprx.listLayouts(layout_name)[0]

    if not layout.mapSeries.enabled:
        print(f"Error: Map Series is not enabled on layout '{layout_name}'.")
        return

    map_series = layout.mapSeries
    page_count = map_series.pageCount
    print(f"Exporting Map Series ({page_count} Pages) to: {output_pdf}...")

    # Configure High-Quality PDF Export Settings
    layout.exportToPDF(
        out_pdf=output_pdf,
        resolution=300,
        image_quality="BEST",
        compress_vector_graphics=True,
        embed_fonts=True
    )

    print(f"✅ Successfully exported multi-page Map Series to: {output_pdf}")

if __name__ == "__main__":
    if len(sys.argv) < 4:
        print("Usage: propy.bat export_map_series.py <project.aprx> <layout_name> <output.pdf>")
        sys.exit(1)
    export_map_series(sys.argv[1], sys.argv[2], sys.argv[3])
```

---


## Technical Troubleshooting Matrix

| Issue & Visual Signature | Root Cause Analysis | Diagnostic & Resolution Pathway |
| :--- | :--- | :--- |
| **Labels Overlapping / Dropped on Busy Maps** | Maplex Label Engine conflict weights set too low or feature label priority unconfigured. | 1. In Map tab, enable **Use Maplex Label Engine**.<br>2. In Label Placement Properties $\rightarrow$ *Conflict Resolution*, enable **Remove Duplicate Labels** and set **Feature Weight** to 1000 for critical layers. |
| **3D Buildings Appear Sunk into Ground Mesh** | 3D feature layer elevation property set to `At an absolute height` rather than `On the ground` or relative to elevation surface. | In Layer Properties $\rightarrow$ **Elevation**, set *Features are* to **Relative to the ground** and link to the project DTM surface. |
| **Raster Displays Completely Black / Low Contrast** | Raster statistics missing, causing default linear stretch across extreme min/max outlier pixels. | 1. In Geoprocessing, run **Calculate Statistics** on the raster dataset.<br>2. In Symbology, set Stretch Type to **Percent Clip** (Min: 0.5%, Max: 0.5%) or **Standard Deviation** ($n=2$). |
| **ModelBuilder Shows Grey Inactive Tools** | One or more input parameters or intermediate output data paths are invalid. | Right-click the grey ModelBuilder process $\rightarrow$ Click **Validate** $\rightarrow$ Reconnect missing input layers. |

---


## Command Line Syntax & Server Control

```bash
# Check ArcGIS Pro Python Environment Packages
"C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3\python.exe" -m pip list

# Launch ArcGIS Pro directly with Specific Project File
"C:\Program Files\ArcGIS\Pro\bin\ArcGISPro.exe" "C:\Projects\RegionalPlanning.aprx"
```

### Key Configuration Locations
- **Project Files**: `*.aprx`
- **Layer Files**: `*.lyrx`

---


## Agent Operational Directive
> **MANDATORY**: When inspecting raster datasets showing black or washed-out displays, always run `Calculate Statistics` before adjusting Stretch Symbology. Use Maplex Label Engine for dense urban maps.