Content
'\n});\n\nmarker.addListener('click', () => {\n infowindow.open(map, marker);\n});\n```\n\n### Mapbox GL JS\n\n```javascript\n// Option 1: Attach to marker\nconst marker = new mapboxgl.Marker()\n .setLngLat([-122.4194, 37.7749])\n .setPopup(new mapboxgl.Popup().setHTML('Content
'))\n .addTo(map);\n\n// Option 2: On layer click (for data-driven markers)\nmap.on('click', 'points-layer', (e) => {\n const coordinates = e.features[0].geometry.coordinates.slice();\n const description = e.features[0].properties.description;\n\n new mapboxgl.Popup().setLngLat(coordinates).setHTML(description).addTo(map);\n});\n```\n\n## Migration Strategy\n\n### Step 1: Audit Current Implementation\n\nIdentify all Google Maps features you use:\n\n- [ ] Basic map with markers\n- [ ] Info windows/popups\n- [ ] Polygons/polylines\n- [ ] Geocoding\n- [ ] Directions\n- [ ] Clustering\n- [ ] Custom styling\n- [ ] Drawing tools\n- [ ] Street View (no Mapbox equivalent)\n- [ ] Other advanced features\n\n### Step 2: Set Up Mapbox\n\n```html\n\n\n\n```\n\n### Step 3: Convert Core Map\n\nStart with basic map initialization:\n\n1. Replace `new google.maps.Map()` with `new mapboxgl.Map()`\n2. Fix coordinate order (lat,lng -> lng,lat)\n3. Update zoom/center\n\n### Step 4: Convert Features One by One\n\nPrioritize by complexity:\n\n1. **Easy:** Map controls, basic markers\n2. **Medium:** Popups, polygons, lines\n3. **Complex:** Clustering, custom styling, data updates\n\n### Step 5: Update Event Handlers\n\nChange event syntax:\n\n- `google.maps.event.addListener()` -> `map.on()`\n- Update event property names (`latLng` -> `lngLat`)\n\n### Step 6: Optimize for Mapbox\n\nTake advantage of Mapbox features:\n\n- Convert multiple markers to data-driven layers\n- Use clustering (built-in)\n- Leverage vector tiles for custom styling\n- Use expressions for dynamic styling\n\n### Step 7: Test Thoroughly\n\n- Cross-browser testing\n- Mobile responsiveness\n- Performance with real data volumes\n- Touch/gesture interactions\n\n## Gotchas and Common Issues\n\n### Coordinate Order\n\n```javascript\n// Google Maps\n{ lat: 37.7749, lng: -122.4194 }\n\n// Mapbox (REVERSED!)\n[-122.4194, 37.7749]\n```\n\n**Always double-check coordinate order!**\n\n### Event Properties\n\n```javascript\n// Google Maps\nmap.on('click', (e) => {\n console.log(e.latLng.lat(), e.latLng.lng());\n});\n\n// Mapbox\nmap.on('click', (e) => {\n console.log(e.lngLat.lat, e.lngLat.lng);\n});\n```\n\n### Timing Issues\n\n```javascript\n// Google Maps - immediate\nconst marker = new google.maps.Marker({ map: map });\n\n// Mapbox - wait for load\nmap.on('load', () => {\n map.addSource(...);\n map.addLayer(...);\n});\n```\n\n### Removing Features\n\n```javascript\n// Google Maps\nmarker.setMap(null);\n\n// Mapbox - must remove both\nmap.removeLayer('layer-id');\nmap.removeSource('source-id');\n```\n\n### Updating Data Without Flash\n\n**Never** remove and re-add layers to update data — this reinitializes WebGL resources and causes a visible flash. Instead:\n\n```javascript\n// ✅ Update data in place (no flash)\nmap.getSource('stores').setData(newGeoJSON);\n\n// ✅ Filter existing data (GPU-side, fastest)\nmap.setFilter('stores-layer', ['==', ['get', 'category'], 'coffee']);\n\n// ❌ BAD: remove + re-add causes flash\nmap.removeLayer('stores-layer');\nmap.removeSource('stores');\nmap.addSource('stores', { ... });\nmap.addLayer({ ... });\n```\n\n## When NOT to Migrate\n\nConsider staying with Google Maps if:\n\n- **Street View is critical** - Mapbox doesn't have equivalent\n- **Tight Google Workspace integration** - Places API deeply integrated\n- **Already heavily optimized** - Migration cost > benefits\n- **Team expertise** - Retraining costs too high\n- **Short-term project** - Not worth migration effort\n\n## Quick Reference: Side-by-Side Comparison\n\n```javascript\n// GOOGLE MAPS\nconst map = new google.maps.Map(el, {\n center: { lat: 37.7749, lng: -122.4194 },\n zoom: 12\n});\n\nconst marker = new google.maps.Marker({\n position: { lat: 37.7749, lng: -122.4194 },\n map: map\n});\n\ngoogle.maps.event.addListener(map, 'click', (e) => {\n console.log(e.latLng.lat(), e.latLng.lng());\n});\n\n// MAPBOX GL JS\nmapboxgl.accessToken = 'YOUR_TOKEN';\nconst map = new mapboxgl.Map({\n container: el,\n center: [-122.4194, 37.7749], // REVERSED!\n zoom: 12,\n style: 'mapbox://styles/mapbox/streets-v12'\n});\n\nconst marker = new mapboxgl.Marker()\n .setLngLat([-122.4194, 37.7749]) // REVERSED!\n .addTo(map);\n\nmap.on('click', (e) => {\n console.log(e.lngLat.lat, e.lngLat.lng);\n});\n```\n\n**Remember:** lng, lat order in Mapbox!\n\n## Additional Resources\n\n- [Mapbox GL JS Documentation](https://docs.mapbox.com/mapbox-gl-js/)\n- [Official Google Maps to Mapbox Migration Guide](https://docs.mapbox.com/help/tutorials/google-to-mapbox/)\n- [Mapbox Examples](https://docs.mapbox.com/mapbox-gl-js/examples/)\n- [Style Specification](https://docs.mapbox.com/mapbox-gl-js/style-spec/)\n\n## Integration with Other Skills\n\n**Works with:**\n\n- **mapbox-web-integration-patterns**: Framework-specific migration guidance\n- **mapbox-web-performance-patterns**: Optimize after migration\n- **mapbox-token-security**: Secure your Mapbox tokens properly\n- **mapbox-geospatial-operations**: Use Mapbox's geospatial tools effectively\n- **mapbox-search-patterns**: Migrate geocoding/search functionality\n\n## Reference Files\n\nThe following reference files contain detailed migration guides for specific topics. Load them when working on those areas:\n\n- **`references/shapes-geocoding.md`** — Polygons, Polylines, Custom Icons, Geocoding\n- **`references/directions-controls.md`** — Directions/Routing, Controls\n- **`references/clustering-styling.md`** — Clustering, Styling/Appearance\n- **`references/data-performance.md`** — Data Updates, Performance, Common Migration Patterns (Store Locator, Drawing Tools, Heatmaps)\n- **`references/api-services.md`** — API Services Comparison, Pricing, Plugins, Framework Integration, Testing, Migration Checklist\n\nTo load a reference, read the file relative to this skill directory, e.g.:\n\n```\nLoad references/shapes-geocoding.md\n```\n","tagline":"Migration guide for developers moving from Google Maps Platform to Mapbox GL JS, covering API equivalents, pattern translations, and key differences","category":"design-creative","tags":["agent-skill"],"author":"mapbox","verified":false,"attribution":{"status":"registry_indexed","statusLabel":"Registry indexed","shortLabel":"REGISTRY INDEXED","sourceLabel":"github candidate review","sourceDetail":"mapbox/mapbox-agent-skills","creatorName":"mapbox","creatorUrl":"https://github.com/mapbox","sourceUrl":"https://github.com/mapbox/mapbox-agent-skills/tree/main/skills/mapbox-google-maps-migration","indexedBy":"OpenAgentSkill community index","claimUrl":"https://www.openagentskill.com/skills/mapbox-mapbox-google-maps-migration#claim-this-skill","claimCta":"Claim this skill","trustNote":"This listing was indexed from public sources and is not marked official until a maintainer claim is approved.","publicNote":"Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals."},"stats":{"stars":75,"forks":15,"verified_installs":0,"successful_runs":0,"total_outcomes":0,"rating":0,"review_count":0,"quality_score":36.57},"quality":{"score":66,"tier":"promising","label":"Promising","summary":"Useful candidate, but compare it with alternatives before adopting.","signals":[{"label":"GitHub stars","value":"75","tone":"neutral"},{"label":"Freshness","value":"23d ago","tone":"positive"},{"label":"Install ready","value":"Yes","tone":"positive"},{"label":"License","value":"MIT","tone":"neutral"}],"warnings":["The data-performance reference uses `source._data` to mutate features, which relies on a private/internal Mapbox GL JS API and could break in future versions."]},"trust":{"version":"trust-score-v5","score":57,"base_score":65,"outcome_confidence":0,"tier":"risk","label":"Do not auto-install","summary":"Trust Score v5 found insufficient evidence for agent installation. Treat this as discovery material, not an executable recommendation.","recommendedAction":"Choose a stronger alternative or inspect the source manually before any install attempt.","decision":{"install_policy":"human_review_before_install","auto_install_allowed":false,"human_review_required":true,"sandbox_first":true,"agent_action":"Compare alternatives before installing.","reasoning":["57/100 Trust Score v5","65/100 Trust Score v4 baseline","Needs more real agent outcomes before unattended install","Install path is available","Review before production"],"review_required_when":["The workspace contains production secrets, payments, private customer data, or irreversible actions.","The install command requests shell, network, credential, database, or broad filesystem access.","Outcome evidence is missing, recently failed, or required human review.","Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"]},"dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":48,"weight":0.13,"status":"warn","detail":"75 GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":48,"weight":0.08,"status":"warn","detail":"75 stars, 15 forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"23d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":86,"weight":0.14,"status":"pass","detail":"Metadata includes enough usage and workflow context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":46,"weight":0.12,"status":"warn","detail":"credential or environment access, external package install surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":34,"weight":0.07,"status":"fail","detail":"secrets or environment access, filesystem or document access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/mapbox/mapbox-agent-skills/tree/main/skills/mapbox-google-maps-migration"},{"id":"review_status","label":"Review status","score":66,"weight":0.05,"status":"info","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"warn","label":"GitHub adoption","detail":"75 GitHub stars"},{"status":"warn","label":"Stars/forks activity","detail":"75 stars, 15 forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"23d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"pass","label":"README/SKILL.md completeness","detail":"Metadata includes enough usage and workflow context"},{"status":"warn","label":"Dependency/runtime risk","detail":"credential or environment access, external package install surface"},{"status":"pass","label":"Install availability","detail":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"fail","label":"Permission surface","detail":"secrets or environment access, filesystem or document access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/mapbox/mapbox-agent-skills/tree/main/skills/mapbox-google-maps-migration"},{"status":"info","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"info","label":"OpenAgentSkill usage","detail":"No local usage activity yet"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["Legacy review approval recorded","Install path is available","Repository evidence is available","Recently maintained repository","Install command has no obvious high-risk pattern","Outcome loop is ready but needs first real agent run"],"warnings":["The data-performance reference uses `source._data` to mutate features, which relies on a private/internal Mapbox GL JS API and could break in future versions.","Financial research output is not financial advice; require human review before any live investment decision.","Quality score needs review","Permission surface needs review: secrets or environment access, filesystem or document access","GitHub adoption: 75 GitHub stars","Stars/forks activity: 75 stars, 15 forks; issue activity unavailable in current metadata","Dependency/runtime risk: credential or environment access, external package install surface","Permission surface: secrets or environment access, filesystem or document access","No real agent outcome reports yet","Human review required before unattended installation"],"evidence":{"stars":"75 GitHub stars","repoActivity":"75 stars, 15 forks","lastPushed":"23d since push","license":"MIT","repository":"https://github.com/mapbox/mapbox-agent-skills/tree/main/skills/mapbox-google-maps-migration","install":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration","installSafety":"standard package or runtime install path","permissionSurface":"secrets or environment access, filesystem or document access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet","agentProvenScore":0,"outcomeConfidence":"0%","installPolicy":"human_review_before_install"},"installReadiness":{"ready":true,"command":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","23d since push","Financial domain: human review is required before use in a live investment workflow.","Trust Score v5 requires review or sandbox-only use before install."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["The data-performance reference uses `source._data` to mutate features, which relies on a private/internal Mapbox GL JS API and could break in future versions.","Financial research output is not financial advice; require human review before any live investment decision.","Quality score needs review","Permission surface needs review: secrets or environment access, filesystem or document access","GitHub adoption: 75 GitHub stars"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Compare alternatives before installing."},"outcome_loop":{"version":"openagentskill-agent-outcome-v4","required_after_install":true,"endpoint":"/api/agent/outcome","method":"POST","event_id_source":"feedback.event_id, install_receipt.resolve_event_id, or decision_packet.outcome_feedback.event_id","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"required_fields":["event_id","skill_slug","task"],"quality_fields":["task_success","output_quality","error_type","human_review_required","used_in_production","workspace","evidence_url","time_to_useful_ms","source_version"],"ranking_inputs_updated":["Trust Score v5 outcome confidence","Agent Proven Score","Resolve ranking task-fit evidence","Skill detail machine-readable metadata","Outcome leaderboard"]},"agent_contract":{"suited_tasks":["design-creative","agent-skill"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"install_command":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration","trust_score":57,"trust_version":"trust-score-v5","risk_level":"medium","do_not_use_when":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Autonomous investment, trading, tax, or suitability decisions without a qualified human review"],"before_install":["Read the audit page and machine-readable metadata.","Confirm the install command, license, and permission surface fit the workspace.","Get explicit human approval or choose an alternative before installing."],"after_run":["Report the outcome to /api/agent/outcome using the resolve event id.","Include output_quality, workspace, human_review_required, and evidence_url when available.","Re-resolve before broad production rollout."]},"bestFor":["design-creative","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Autonomous investment, trading, tax, or suitability decisions without a qualified human review"],"knownRisks":["The data-performance reference uses `source._data` to mutate features, which relies on a private/internal Mapbox GL JS API and could break in future versions.","Financial research output is not financial advice; require human review before any live investment decision.","Quality score needs review","Permission surface needs review: secrets or environment access, filesystem or document access","GitHub adoption: 75 GitHub stars","Stars/forks activity: 75 stars, 15 forks; issue activity unavailable in current metadata","Dependency/runtime risk: credential or environment access, external package install surface","Permission surface: secrets or environment access, filesystem or document access"],"backward_compatible":{"trust_score_v4":{"version":"trust-score-v4","score":65,"tier":"review","label":"Manual review","summary":"Potentially useful, but at least one trust signal needs human inspection."}}},"trust_score_v5":{"version":"trust-score-v5","score":57,"base_score":65,"outcome_confidence":0,"tier":"risk","label":"Do not auto-install","summary":"Trust Score v5 found insufficient evidence for agent installation. Treat this as discovery material, not an executable recommendation.","recommendedAction":"Choose a stronger alternative or inspect the source manually before any install attempt.","decision":{"install_policy":"human_review_before_install","auto_install_allowed":false,"human_review_required":true,"sandbox_first":true,"agent_action":"Compare alternatives before installing.","reasoning":["57/100 Trust Score v5","65/100 Trust Score v4 baseline","Needs more real agent outcomes before unattended install","Install path is available","Review before production"],"review_required_when":["The workspace contains production secrets, payments, private customer data, or irreversible actions.","The install command requests shell, network, credential, database, or broad filesystem access.","Outcome evidence is missing, recently failed, or required human review.","Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"]},"dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":48,"weight":0.13,"status":"warn","detail":"75 GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":48,"weight":0.08,"status":"warn","detail":"75 stars, 15 forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"23d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":86,"weight":0.14,"status":"pass","detail":"Metadata includes enough usage and workflow context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":46,"weight":0.12,"status":"warn","detail":"credential or environment access, external package install surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":34,"weight":0.07,"status":"fail","detail":"secrets or environment access, filesystem or document access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/mapbox/mapbox-agent-skills/tree/main/skills/mapbox-google-maps-migration"},{"id":"review_status","label":"Review status","score":66,"weight":0.05,"status":"info","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"warn","label":"GitHub adoption","detail":"75 GitHub stars"},{"status":"warn","label":"Stars/forks activity","detail":"75 stars, 15 forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"23d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"pass","label":"README/SKILL.md completeness","detail":"Metadata includes enough usage and workflow context"},{"status":"warn","label":"Dependency/runtime risk","detail":"credential or environment access, external package install surface"},{"status":"pass","label":"Install availability","detail":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"fail","label":"Permission surface","detail":"secrets or environment access, filesystem or document access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/mapbox/mapbox-agent-skills/tree/main/skills/mapbox-google-maps-migration"},{"status":"info","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"info","label":"OpenAgentSkill usage","detail":"No local usage activity yet"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["Legacy review approval recorded","Install path is available","Repository evidence is available","Recently maintained repository","Install command has no obvious high-risk pattern","Outcome loop is ready but needs first real agent run"],"warnings":["The data-performance reference uses `source._data` to mutate features, which relies on a private/internal Mapbox GL JS API and could break in future versions.","Financial research output is not financial advice; require human review before any live investment decision.","Quality score needs review","Permission surface needs review: secrets or environment access, filesystem or document access","GitHub adoption: 75 GitHub stars","Stars/forks activity: 75 stars, 15 forks; issue activity unavailable in current metadata","Dependency/runtime risk: credential or environment access, external package install surface","Permission surface: secrets or environment access, filesystem or document access","No real agent outcome reports yet","Human review required before unattended installation"],"evidence":{"stars":"75 GitHub stars","repoActivity":"75 stars, 15 forks","lastPushed":"23d since push","license":"MIT","repository":"https://github.com/mapbox/mapbox-agent-skills/tree/main/skills/mapbox-google-maps-migration","install":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration","installSafety":"standard package or runtime install path","permissionSurface":"secrets or environment access, filesystem or document access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet","agentProvenScore":0,"outcomeConfidence":"0%","installPolicy":"human_review_before_install"},"installReadiness":{"ready":true,"command":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","23d since push","Financial domain: human review is required before use in a live investment workflow.","Trust Score v5 requires review or sandbox-only use before install."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["The data-performance reference uses `source._data` to mutate features, which relies on a private/internal Mapbox GL JS API and could break in future versions.","Financial research output is not financial advice; require human review before any live investment decision.","Quality score needs review","Permission surface needs review: secrets or environment access, filesystem or document access","GitHub adoption: 75 GitHub stars"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Compare alternatives before installing."},"outcome_loop":{"version":"openagentskill-agent-outcome-v4","required_after_install":true,"endpoint":"/api/agent/outcome","method":"POST","event_id_source":"feedback.event_id, install_receipt.resolve_event_id, or decision_packet.outcome_feedback.event_id","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"required_fields":["event_id","skill_slug","task"],"quality_fields":["task_success","output_quality","error_type","human_review_required","used_in_production","workspace","evidence_url","time_to_useful_ms","source_version"],"ranking_inputs_updated":["Trust Score v5 outcome confidence","Agent Proven Score","Resolve ranking task-fit evidence","Skill detail machine-readable metadata","Outcome leaderboard"]},"agent_contract":{"suited_tasks":["design-creative","agent-skill"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"install_command":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration","trust_score":57,"trust_version":"trust-score-v5","risk_level":"medium","do_not_use_when":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Autonomous investment, trading, tax, or suitability decisions without a qualified human review"],"before_install":["Read the audit page and machine-readable metadata.","Confirm the install command, license, and permission surface fit the workspace.","Get explicit human approval or choose an alternative before installing."],"after_run":["Report the outcome to /api/agent/outcome using the resolve event id.","Include output_quality, workspace, human_review_required, and evidence_url when available.","Re-resolve before broad production rollout."]},"bestFor":["design-creative","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Autonomous investment, trading, tax, or suitability decisions without a qualified human review"],"knownRisks":["The data-performance reference uses `source._data` to mutate features, which relies on a private/internal Mapbox GL JS API and could break in future versions.","Financial research output is not financial advice; require human review before any live investment decision.","Quality score needs review","Permission surface needs review: secrets or environment access, filesystem or document access","GitHub adoption: 75 GitHub stars","Stars/forks activity: 75 stars, 15 forks; issue activity unavailable in current metadata","Dependency/runtime risk: credential or environment access, external package install surface","Permission surface: secrets or environment access, filesystem or document access"],"backward_compatible":{"trust_score_v4":{"version":"trust-score-v4","score":65,"tier":"review","label":"Manual review","summary":"Potentially useful, but at least one trust signal needs human inspection."}}},"trust_score_v4":{"version":"trust-score-v4","score":65,"tier":"review","label":"Manual review","summary":"Potentially useful, but at least one trust signal needs human inspection.","recommendedAction":"Inspect the repository, license, and recent activity before connecting it to agent workflows.","dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":48,"weight":0.13,"status":"warn","detail":"75 GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":48,"weight":0.08,"status":"warn","detail":"75 stars, 15 forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"23d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":86,"weight":0.14,"status":"pass","detail":"Metadata includes enough usage and workflow context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":46,"weight":0.12,"status":"warn","detail":"credential or environment access, external package install surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":34,"weight":0.07,"status":"fail","detail":"secrets or environment access, filesystem or document access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/mapbox/mapbox-agent-skills/tree/main/skills/mapbox-google-maps-migration"},{"id":"review_status","label":"Review status","score":66,"weight":0.05,"status":"info","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"warn","label":"GitHub adoption","detail":"75 GitHub stars"},{"status":"warn","label":"Stars/forks activity","detail":"75 stars, 15 forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"23d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"pass","label":"README/SKILL.md completeness","detail":"Metadata includes enough usage and workflow context"},{"status":"warn","label":"Dependency/runtime risk","detail":"credential or environment access, external package install surface"},{"status":"pass","label":"Install availability","detail":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"fail","label":"Permission surface","detail":"secrets or environment access, filesystem or document access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/mapbox/mapbox-agent-skills/tree/main/skills/mapbox-google-maps-migration"},{"status":"info","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"info","label":"OpenAgentSkill usage","detail":"No local usage activity yet"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["Legacy review approval recorded","Install path is available","Repository evidence is available","Recently maintained repository","Install command has no obvious high-risk pattern"],"warnings":["The data-performance reference uses `source._data` to mutate features, which relies on a private/internal Mapbox GL JS API and could break in future versions.","Financial research output is not financial advice; require human review before any live investment decision.","Quality score needs review","Permission surface needs review: secrets or environment access, filesystem or document access","GitHub adoption: 75 GitHub stars","Stars/forks activity: 75 stars, 15 forks; issue activity unavailable in current metadata","Dependency/runtime risk: credential or environment access, external package install surface","Permission surface: secrets or environment access, filesystem or document access"],"evidence":{"stars":"75 GitHub stars","repoActivity":"75 stars, 15 forks","lastPushed":"23d since push","license":"MIT","repository":"https://github.com/mapbox/mapbox-agent-skills/tree/main/skills/mapbox-google-maps-migration","install":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration","installSafety":"standard package or runtime install path","permissionSurface":"secrets or environment access, filesystem or document access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet"},"installReadiness":{"ready":true,"command":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","23d since push","Financial domain: human review is required before use in a live investment workflow."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["The data-performance reference uses `source._data` to mutate features, which relies on a private/internal Mapbox GL JS API and could break in future versions.","Financial research output is not financial advice; require human review before any live investment decision.","Quality score needs review","Permission surface needs review: secrets or environment access, filesystem or document access","GitHub adoption: 75 GitHub stars"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Human review or sandbox validation is required before automatic installation."},"bestFor":["design-creative","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Autonomous investment, trading, tax, or suitability decisions without a qualified human review"],"knownRisks":["The data-performance reference uses `source._data` to mutate features, which relies on a private/internal Mapbox GL JS API and could break in future versions.","Financial research output is not financial advice; require human review before any live investment decision.","Quality score needs review","Permission surface needs review: secrets or environment access, filesystem or document access","GitHub adoption: 75 GitHub stars","Stars/forks activity: 75 stars, 15 forks; issue activity unavailable in current metadata","Dependency/runtime risk: credential or environment access, external package install surface","Permission surface: secrets or environment access, filesystem or document access"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"outcome_stats":null,"safety":{"score":38,"level":"avoid_auto_install","label":"Avoid automatic install","safety_tier":{"tier":"experimental","label":"Experimental","badge":"EXPERIMENTAL","summary":"Sparse or mixed signals. Useful for discovery, but not for autonomous installation.","recommended_action":"Test manually in an isolated workspace and compare against safer alternatives.","auto_install_policy":"review","reasons":["High-risk permission hints: Secrets or environment access","38/100 agent safety score"]},"auto_install_allowed":false,"human_review_required":true,"blocked":false,"audit_risk":"needs_review","permission_hints":[{"id":"browser","label":"Browser automation","reason":"Skill may drive a browser or interact with web pages.","severity":"medium"},{"id":"network","label":"Network access","reason":"Skill likely fetches remote pages, APIs, repositories, or external services.","severity":"medium"},{"id":"filesystem","label":"Filesystem access","reason":"Skill may read or write project files, documents, generated artifacts, or local workspace state.","severity":"medium"},{"id":"secrets","label":"Secrets or environment access","reason":"Skill metadata references credentials, tokens, environment variables, or secret-bearing workflows.","severity":"high"},{"id":"database","label":"Database access","reason":"Skill may inspect schemas, query databases, or work with persistent stores.","severity":"medium"}],"policy_warnings":["High-risk permission hints: Secrets or environment access","Dependency or permission surface needs review"],"constraints_applied":{"max_risk":"medium","needs_install_command":true,"min_stars":0}},"safety_gate":{"tier":"experimental","label":"Experimental","badge":"EXPERIMENTAL","auto_install_policy":"review","auto_install_allowed":false,"blocked":false,"human_review_required":true,"recommended_action":"Test manually in an isolated workspace and compare against safer alternatives.","reasons":["High-risk permission hints: Secrets or environment access","38/100 agent safety score"]},"eval":{"version":"openagentskill-skill-eval-v1","status":"failed","score":64,"risk_level":"high","decision":{"recommendation":"do_not_auto_install","reason":"Permission surface: secrets or environment access, filesystem or document access","auto_install_allowed":false,"policy":"block","human_review_required":true},"blockers":["Permission surface: secrets or environment access, filesystem or document access"],"warnings":["Trust score: Potentially useful, but at least one trust signal needs human inspection.","Audit score: Needs review","Agent safety gate: Sparse or mixed signals. Useful for discovery, but not for autonomous installation.","High-risk permission hints: Secrets or environment access","Dependency or permission surface needs review","Permission surface may require sandboxing","Financial research output is not financial advice; require human review before any live investment decision","The data-performance reference uses `source._data` to mutate features, which relies on a private/internal Mapbox GL JS API and could break in future versions.","SKILL.md does not include an explicit 'When to use' or 'How to use' workflow section, so an agent may need to infer how to apply the migration guidance.","Financial research output is not financial advice; require human review before any live investment decision.","Quality score needs review","Permission surface needs review: secrets or environment access, filesystem or document access"],"validation_plan":["Inspect repository, README/SKILL.md, license, and recent commits before production use.","Install in an isolated workspace or sandbox with no production secrets available.","Run the smallest representative task and record files touched, commands run, network access, and outputs.","Compare the selected skill against at least one alternative when the eval status is review or failed.","Promote only after the agent reports a successful verification result and unresolved warnings are accepted."],"checks":[{"id":"task_fit","label":"Task fit","status":"pass","score":84,"required_for_auto_install":true,"detail":"Task wording matches this skill metadata.","evidence":["Evaluate mapbox-google-maps-migration before installing it in an agent workflow","design-creative","Design and creative workflows; Claude Code teams; builders willing to evaluate younger projects"]},{"id":"install_path","label":"Install path","status":"pass","score":92,"required_for_auto_install":true,"detail":"Install handoff is available.","evidence":["npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration"]},{"id":"install_safety","label":"Install command safety","status":"pass","score":92,"required_for_auto_install":true,"detail":"standard package or runtime install path","evidence":["npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration"]},{"id":"trust_score","label":"Trust score","status":"warn","score":65,"required_for_auto_install":true,"detail":"Potentially useful, but at least one trust signal needs human inspection.","evidence":["Manual review","75 GitHub stars","MIT"]},{"id":"audit_score","label":"Audit score","status":"warn","score":74,"required_for_auto_install":true,"detail":"Needs review","evidence":["Dependency or permission surface needs review"]},{"id":"agent_safety_gate","label":"Agent safety gate","status":"warn","score":38,"required_for_auto_install":true,"detail":"Sparse or mixed signals. Useful for discovery, but not for autonomous installation.","evidence":["Test manually in an isolated workspace and compare against safer alternatives.","High-risk permission hints: Secrets or environment access"]},{"id":"readme_skillmd_completeness","label":"README/SKILL.md completeness","status":"pass","score":86,"required_for_auto_install":false,"detail":"Metadata includes enough usage and workflow context","evidence":["Strong README/SKILL.md context"]},{"id":"license_clarity","label":"License clarity","status":"pass","score":86,"required_for_auto_install":true,"detail":"MIT","evidence":["MIT"]},{"id":"recent_maintenance","label":"Recent maintenance","status":"pass","score":100,"required_for_auto_install":false,"detail":"23d since push","evidence":["23d since push"]},{"id":"permission_surface","label":"Permission surface","status":"fail","score":34,"required_for_auto_install":true,"detail":"secrets or environment access, filesystem or document access","evidence":["Browser automation: medium","Network access: medium","Filesystem access: medium"]},{"id":"alternatives","label":"Alternatives available","status":"info","score":55,"required_for_auto_install":false,"detail":"No close alternatives were found in the current shortlist.","evidence":[]}],"endpoints":{"web":"https://www.openagentskill.com/skills/mapbox-mapbox-google-maps-migration/evals","api":"/api/agent/evals?slug=mapbox-mapbox-google-maps-migration","text":"/api/agent/evals?slug=mapbox-mapbox-google-maps-migration&format=text"}},"agent_readable_metadata":{"version":"openagentskill-agent-metadata-v2","review_evidence":{"indexed":true,"static_checked":false,"ai_reviewed":false,"manual_reviewed":false,"creator_verified":false,"review_result":"not_recorded","reviewed_at":null,"package_fingerprint":null,"policy_version":null,"notice":"Publication, static checks, AI review, and creator verification are independent facts. None guarantees runtime safety."},"skill":{"slug":"mapbox-mapbox-google-maps-migration","name":"mapbox-google-maps-migration","description":"Migration guide for developers moving from Google Maps Platform to Mapbox GL JS, covering API equivalents, pattern translations, and key differences","category":"design-creative","url":"https://www.openagentskill.com/skills/mapbox-mapbox-google-maps-migration","repository":"https://github.com/mapbox/mapbox-agent-skills/tree/main/skills/mapbox-google-maps-migration","github_repo":"mapbox/mapbox-agent-skills"},"suited_tasks":["Design and creative workflows","Claude Code teams","builders willing to evaluate younger projects","Inspect visual requirements","Generate reusable assets","Package output for review","Understand table relationships","Write safer queries"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI","Browser agents","CLI"],"install":{"source_evidence":{"status":"source-recorded","sourceRecorded":true,"canOfferInstall":true,"path":"skills/mapbox-google-maps-migration/SKILL.md","revision":"209e8c408fd65edfff45e491c941e8a00025a1a6","notice":"A skill instruction path and install command are recorded. This is not proof of compatibility, runtime success or safety; review the source and permissions first."},"command":"npx skills add mapbox/mapbox-agent-skills --skill mapbox-google-maps-migration","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add mapbox-mapbox-google-maps-migration"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"mapbox-google-maps-migration\" agent skill from https://github.com/mapbox/mapbox-agent-skills/tree/main/skills/mapbox-google-maps-migration. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Migration guide for developers moving from Google Maps Platform to Mapbox GL JS, covering API equivalents, pattern translations, and key differences After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_