arcgis-maps-sdk-js-ai-context

[!CAUTION] This is work in progress and not yet tested extensively. Use at your own risk.

Install Agent Skills for ArcGIS Maps SDK for JavaScript development. Compatible with Claude, VS Code, Cursor, and other AI agents.

Features

• Agent Skills: Comprehensive skill files following the open Agent Skills specification
• Cross-platform AI support: Works with Claude, VS Code Copilot, Cursor, OpenCode, and other compatible agents
• SDK Version Selection: Choose skills for specific ArcGIS Maps SDK versions
• Cross-platform: Works on Windows, macOS, and Linux
• Zero dependencies: Uses only built-in Node.js modules

Installation

No installation required! Run directly with npx:

npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context <command>

Commands

Install Agent Skills

Installs Agent Skills directly to .github/skills/ in your project (35 skills for SDK 5.0, 31 for SDK 4.34):

# Install for latest SDK version
npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context skills

# Install for specific SDK version
npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context skills --sdk 4.34

This creates the following structure (all skills are prefixed with arcgis- to avoid conflicts with other packages):

your-project/
└── .github/
    └── skills/
        ├── arcgis-starter-app/
        │   └── SKILL.md
        ├── arcgis-core-maps/
        │   └── SKILL.md
        ├── arcgis-layers/
        │   └── SKILL.md
        ├── arcgis-widgets-ui/
        │   └── SKILL.md
        └── ... (35 skill directories for SDK 5.0)

List Available Skills

Shows all available SDK versions and skills:

npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context list

Help

npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context --help

SDK Version Selection

Use the --sdk flag to install skills for a specific ArcGIS Maps SDK version:

npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context skills --sdk 4.34

Available versions can be viewed with the list command. If no version is specified, the latest available version is used.

| SDK Version | Skills | Status | |-------------|--------|--------| | 5.0 | 35 | Available (latest) | | 4.34 | 31 | Available |

Skills Included

The package includes 35 Agent Skills for SDK 5.0 (31 for SDK 4.34) covering:

| Skill | Description | |-------|-------------| | arcgis-starter-app | Scaffold TypeScript/Vite apps (minimal and production-ready setups) | | arcgis-core-maps | 2D and 3D map creation, views, navigation, arcgis-video | | arcgis-layers | FeatureLayer, TileLayer, GeoJSONLayer, and more | | arcgis-advanced-layers | WMS, WFS, WMTS, OGC, MapImageLayer, CatalogLayer, MediaLayer | | arcgis-visualization | Renderers, symbols, labels, and visual variables | | arcgis-smart-mapping | Smart mapping and data-driven visualization | | arcgis-popup-templates | Popup configuration and content | | arcgis-widgets-ui | Built-in widgets and UI components | | arcgis-widgets-advanced | BuildingExplorer, FloorFilter, Track, Locate, ScaleBar, and more | | arcgis-geometry-operations | Geometry operators and spatial operations | | arcgis-coordinates-projection | Coordinate systems and projections | | arcgis-spatial-analysis | Spatial analysis, feature reduction, and analysis objects | | arcgis-rest-services | REST service wrappers for routing, geocoding, printing, places | | arcgis-3d-layers | VoxelLayer, PointCloudLayer, glTF imports, 3D analysis components | | arcgis-scene-environment | SceneView environment, shadows, lighting, atmosphere | | arcgis-feature-effects | Feature effects, filters, and blend modes | | arcgis-cim-symbols | CIM symbol specification | | arcgis-arcade | Arcade expressions | | arcgis-time-animation | Time-aware layers and animation | | arcgis-editing | Editor widget, forms, subtypes, versioning | | arcgis-interaction | Hit testing, highlighting, sketching, and events | | arcgis-map-tools | Measurement, print, directions, and utility tools | | arcgis-tables-forms | Attribute tables and feature forms | | arcgis-custom-rendering | Custom WebGL rendering and LayerView architecture | | arcgis-imagery | Imagery and raster analysis | | arcgis-authentication | OAuth, API keys, and identity management | | arcgis-portal-content | Portal items, groups, and content management | | arcgis-knowledge-graphs | Knowledge graph integration and link charts | | arcgis-utility-networks | Utility network analysis | | arcgis-performance | Bundle optimization, lazy loading, memory management, view performance | | arcgis-ai-components | AI-powered map chat via arcgis-ai-chat and arcgis-ai-toolbar (5.0 only) | | arcgis-charts | Interactive charts from layer data via @arcgis/charts-components (5.0 only) | | arcgis-coding-components | Arcade expression editor via @arcgis/coding-components (5.0 only) | | arcgis-embeddable-maps | Lightweight self-contained map embeds via @arcgis/embeddable-components (5.0 only) | | arcgis-core-utilities | Accessor, Collection, reactiveUtils, intl, and workers |

Usage

After installing skills, your AI agent will automatically have access to ArcGIS-specific knowledge when working in your project. The skills provide:

• Correct import patterns for ESM and Map Components
• Best practices for TypeScript with autocasting
• Code examples for common tasks
• Reference samples linking to official SDK sample code
• Common pitfalls and how to avoid them
• Cross-references between related skills

Supported AI Agents

• Claude / Claude Code
• VS Code with Copilot
• Cursor
• OpenCode
• Any agent supporting the Agent Skills specification

Requirements

• Node.js 14.0.0 or higher

Source

The skills in this package are based on the official ArcGIS Maps SDK for JavaScript documentation:

• Documentation: https://developers.arcgis.com/javascript/latest/downloads/
• Folders used: api-reference and sample-code and map-components

AI Assistance Declaration

This project was primarily developed using AI coding assistants. The maintainer directed the development through prompts and reviewed all generated code.

License

MIT

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests at:

https://github.com/SaschaBrunnerCH/arcgis-maps-sdk-js-ai-context

Related

• ArcGIS Maps SDK for JavaScript
• Agent Skills Specification
• Claude