arcgis-maps-sdk-js-ai-context (SDK 4.26)
[!CAUTION]
This is work in progress and not yet tested extensively. Use at your own risk.
Agent Skills for ArcGIS Maps SDK for JavaScript version 4.26 development. Designed for Claude Code and Codex.
What this is
31 Agent Skills (each a folder with a SKILL.md) that give an AI coding agent
accurate, version-correct knowledge of the ArcGIS Maps SDK for JavaScript 4.26:
import patterns, code examples, widget/Core-API usage, and common pitfalls.
About 4.26 (June 2023): This version predates Map Components / web components
(introduced 4.28+) and geometry operators (4.30+). The skills use the Core API only —
new MapView() / new SceneView(), classic widgets placed via view.ui.add(), and
geometryEngine / projection / geodesicUtils for geometry. ESM (@arcgis/core) and
AMD module patterns are both covered.
Supported agents
| Agent | Integration |
|---|
| Claude Code | Plugin (.claude-plugin/) — installs the skills/ folder |
| Codex | Skills discovered from ~/.agents/skills/ via a symlink |
Install — Claude Code
Claude Code loads this repository as a plugin; its skills become available automatically.
# In Claude Code:
/plugin marketplace add elowen53/arcgis-maps-sdk-js-ai-context-4.0
/plugin install arcgis-maps-sdk-js-ai-context@arcgis-maps-sdk-js-skills
Then reload plugins (/reload-plugins if needed). The 31 ArcGIS skills are now
auto-discovered and invoked when relevant.
Alternative (no plugin): copy the skills into your project's .claude/skills/:
git clone https://github.com/elowen53/arcgis-maps-sdk-js-ai-context-4.0.git
mkdir -p .claude/skills
cp -r arcgis-maps-sdk-js-ai-context/skills/* .claude/skills/
Install — Codex
See .codex/INSTALL.md. In short:
git clone https://github.com/elowen53/arcgis-maps-sdk-js-ai-context-4.0.git ~/.codex/arcgis-maps-sdk-js-ai-context
mkdir -p ~/.agents/skills
ln -s ~/.codex/arcgis-maps-sdk-js-ai-context/skills ~/.agents/skills/arcgis-maps-sdk-js-ai-context
Restart Codex; run /skills to confirm the 31 ArcGIS skills are discovered.
Repository layout
arcgis-maps-sdk-js-ai-context/
├── skills/ # 31 Agent Skills (SDK 4.26)
│ ├── arcgis-core-maps/
│ │ ├── SKILL.md
│ │ └── AGENTS.md
│ └── ... (30 more)
├── .claude-plugin/ # Claude Code plugin + marketplace manifest
│ ├── plugin.json
│ └── marketplace.json
├── .codex/ # Codex install instructions
│ └── INSTALL.md
├── AGENTS.md # Skill catalog / decision guides
└── scripts/validate-skills.js # Structure validator
Skills included (31)
| Skill | Description |
|---|
| arcgis-starter-app | Scaffold TypeScript/Vite apps with @arcgis/core |
| arcgis-core-maps | 2D MapView / 3D SceneView creation, navigation, basemaps (Core API) |
| arcgis-core-utilities | Accessor, Collection, reactiveUtils, promiseUtils, intl, workers |
| arcgis-performance | Bundle optimization, lazy loading, memory management, view tuning |
| arcgis-layers | FeatureLayer, TileLayer, GeoJSONLayer, CSVLayer, GraphicsLayer, queries |
| arcgis-advanced-layers | WMS, WFS, WMTS, OGC, MapImageLayer, MediaLayer |
| arcgis-3d-layers | SceneLayer, IntegratedMeshLayer, PointCloudLayer, VoxelLayer, 3D analysis widgets |
| arcgis-tables-forms | FeatureTable and FeatureForm widgets, related records |
| arcgis-visualization | Renderers, symbols, labels, visual variables |
| arcgis-cim-symbols | CIM symbol specification |
| arcgis-smart-mapping | Data-driven renderer/color/size generators, statistics |
| arcgis-feature-effects | Layer effects, filters, blend modes |
| arcgis-interaction | Hit testing, highlighting, sketching, events, Draw API |
| arcgis-popup-templates | PopupTemplate content, Arcade, custom actions |
| arcgis-editing | Editor widget, FeatureForm, subtypes, branch versioning, applyEdits |
| arcgis-widgets-ui | Legend, LayerList, Search, FeatureTable, TimeSlider via view.ui.add() |
| arcgis-widgets-advanced | Measurement, ElevationProfile, LineOfSight, Print, Swipe, Directions |
| arcgis-geometry-operations | geometryEngine/geometryEngineAsync, geodesic operations |
| arcgis-spatial-analysis | Server-side geoprocessing and analysis |
| arcgis-coordinates-projection | projection module, spatial references, coordinateFormatter |
| arcgis-rest-services | REST wrappers for routing, geocoding, printing, queries |
| arcgis-portal-content | Portal items, WebMap/WebScene loading, sharing |
| arcgis-authentication | OAuth 2.0 (OAuthInfo + IdentityManager), API keys |
| arcgis-map-tools | Bookmarks, measurement, print, directions, coordinate conversion |
