docs: add maps-usage AI skill

[lodev09]

Summary

Adds a consumer-facing AI skill so coding agents know how to use @lugg/maps, installable with npx skills add lugg/maps.

• skills/maps-usage/SKILL.md - quick start, setup, providers, camera, recipes, debugging rules, platform matrix, events, methods
• references/configuration.md - setup snippets and every prop with platform support
• references/api.md - ref methods, events, payload types
• references/advanced-patterns.md - sheet edge insets and center pin, marker registry, Reanimated marker along a route, fitted static camera, provider switching, permissions, GeoJSON, web, Apple-only builds, Jest mock
• references/troubleshooting.md - symptom to fix entries
• README, usage.mdx, and docs home page showcase the skill; AGENTS.md documents how to keep it in sync

Written from src/ and native code, not only the docs. Mismatches found but not fixed here: docs list the camera payload field as dragging (source uses gesture), minZoom/maxZoom are missing from the MapView props table, and index.web.ts exports fewer types than index.ts.

Type of Change

• Bug fix
• New feature
• Breaking change
• Documentation update

Test Plan

• yarn docs typecheck passes
• Prettier clean on the home page
• Docs home page not visually verified

Screenshots / Videos

N/A

Checklist

• I tested on iOS
• I tested on Android
• I tested on Web
• I updated the documentation (if needed)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
lugg-maps	Ready	Preview	Sep 21, 2026 7:18pm UTC