QGIS Claude Skill Package

19 deterministic skills for spatial data analysis, map creation, geoprocessing, and plugin development with QGIS/PyQGIS and Claude Code.

What This Is

A skill package that teaches Claude how to write correct, production-quality PyQGIS code. Every skill uses deterministic ALWAYS/NEVER language, includes working code examples, and documents anti-patterns with fix patterns.

Target version: QGIS 3.44 LTR (with QGIS 4.0 Qt6 compatibility notes)

Installation

Claude Code (recommended)

claude install-skill https://github.com/OpenAEC-Foundation/QGIS-Claude-Skill-Package

Manual

Clone the repository into your Claude Code skills directory:

git clone https://github.com/OpenAEC-Foundation/QGIS-Claude-Skill-Package.git

Then add the skills path to your Claude Code configuration.

Skill Catalog

Core (3 skills) — Foundation

Skill	What it covers
qgis-core-architecture	QGIS modules, project lifecycle, layer model, provider system, threading
qgis-core-data-providers	12+ providers, URI formats for every data source, GeoPackage best practices
qgis-core-coordinate-systems	CRS creation, transforms, datum handling, distance measurement

Syntax (4 skills) — How to write PyQGIS

Skill	What it covers
qgis-syntax-pyqgis-api	Feature CRUD, geometry ops, spatial indexing, QgsTask, symbology
qgis-syntax-expressions	Expression engine, field calculator, custom @qgsfunction, data-defined properties
qgis-syntax-processing-scripts	processing.run(), custom algorithms, parameter types, batch processing
qgis-syntax-plugins	Plugin structure, metadata.txt, lifecycle, Qt Designer, publishing

Implementation (8 skills) — GIS workflows

Skill	What it covers
qgis-impl-vector-analysis	Spatial queries, buffer/clip/intersect/dissolve, joins, QgsVectorFileWriter
qgis-impl-raster-analysis	Map algebra, DEM analysis (hillshade/slope/aspect), GDAL algorithms
qgis-impl-print-layouts	Layout composition, atlas generation, PDF/SVG/image export
qgis-impl-postgis	PostGIS connection, SQL execution, authentication, schema discovery
qgis-impl-web-services	WMS/WFS/WMTS clients, XYZ tiles, QGIS Server, OGC API
qgis-impl-3d-visualization	3D scenes, terrain providers, 3D symbols, materials, point clouds
qgis-impl-georeferencing	GCP management, 7 transformation types, vector/raster georeferencing
qgis-impl-network-analysis	Dijkstra shortest path, service area analysis, graph building

Errors (2 skills) — Diagnosis

Skill	What it covers
qgis-errors-projections	CRS errors, lat/lon confusion, datum warnings, diagnostic flowchart
qgis-errors-data-loading	Invalid layers, URI errors, encoding, GeoPackage locking, performance

Agents (2 skills) — Orchestration

Skill	What it covers
qgis-agents-analysis-orchestrator	Analysis planning, algorithm selection, workflow chaining, code validation
qgis-agents-map-generator	Full map pipeline: data loading → styling → layout → export

How to Use

Goal	Start with
Plan a spatial analysis	qgis-agents-analysis-orchestrator
Generate a map	qgis-agents-map-generator
Write PyQGIS code	qgis-syntax-pyqgis-api
Load specific data format	qgis-core-data-providers
Debug projection issues	qgis-errors-projections
Build a QGIS plugin	qgis-syntax-plugins
Run processing algorithms	qgis-syntax-processing-scripts

Skill Structure

Each skill follows the same structure:

qgis-{category}-{topic}/
├── SKILL.md              # Main skill (<500 lines, YAML frontmatter)
└── references/
    ├── methods.md         # API signatures and class references
    ├── examples.md        # Working code examples
    └── anti-patterns.md   # What NOT to do (WRONG/CORRECT pairs)

Quality Guarantees

• All SKILL.md files < 500 lines
• Deterministic ALWAYS/NEVER language (zero hedging words)
• Working PyQGIS code examples verified against official documentation
• Anti-patterns with WRONG/CORRECT code pairs and WHY explanations
• English-only content (Claude responds in any language automatically)
• QGIS 3.44 LTR target with 4.0 compatibility notes

Complementary MCP Servers

This skill package teaches Claude how to write PyQGIS code. For runtime QGIS control, pair with:

MCP Server	What it does
jjsantos01/qgis_mcp	Control running QGIS instance (855 stars, 15 tools)
nkarasiak/qgis-mcp	Most comprehensive QGIS MCP (51 tools)
Wayfinder-Foundry/gdal-mcp	GDAL raster/vector operations (MIT)

License

MIT License. See LICENSE for details.

Author

OpenAEC Foundation

---

Companion Skills: Cross-Technology Integration

Cross-Tech AEC Integration Skills — 15 skills for technology boundaries

Skill	Boundary	What it adds
crosstech-impl-qgis-bim-georef	QGIS ↔ BIM/IFC	Import IFC footprints, CRS from IfcMapConversion, GeoPackage export
crosstech-core-coordinate-systems	BIM ↔ GIS	EPSG codes, pyproj pipelines, IfcMapConversion formulas
crosstech-errors-coordinate-mismatch	BIM ↔ GIS	Debug wrong locations, CRS errors, axis mismatches
crosstech-impl-docker-aec-stack	Docker ↔ QGIS	QGIS Server containerization

---

Built with the Skill Package Workflow Template — a 7-phase research-first methodology proven across 5 packages and 150+ skills.