Skip to content

Conversation

@mattpodwysocki
Copy link
Contributor

Summary

Removes skill directories from mcp-devkit-server and directs users to install skills from the official mapbox-agent-skills repository.

Changes

Removed:

  • skills/mapbox-cartography/
  • skills/mapbox-integration-patterns/
  • skills/mapbox-style-patterns/
  • skills/mapbox-style-quality/
  • skills/mapbox-token-security/

Updated:

  • skills/README.md - Now points to mapbox-agent-skills repo with installation instructions

Why Move Skills to Separate Repository?

Benefits:

  • Dedicated maintenance: Skills can be updated independently from MCP server
  • Better discoverability: Easier to find via npx add-skill mapbox/mapbox-agent-skills
  • Comprehensive collection: 10 skills (vs 5 here) covering web, mobile, and migration
  • Community contributions: Easier for community to contribute new skills
  • Versioning: Skills versioned independently from MCP server
  • AGENTS.md files: New repository includes compressed quick-reference files that install with skills

New Installation Method

Users should now install skills from the dedicated repository:

# Install all Mapbox skills
npx add-skill mapbox/mapbox-agent-skills

# Install specific skills
npx add-skill mapbox/mapbox-agent-skills --skill mapbox-web-performance-patterns
npx add-skill mapbox/mapbox-agent-skills --skill mapbox-token-security

What's in mapbox-agent-skills?

10 comprehensive skills:

  • mapbox-google-maps-migration
  • mapbox-maplibre-migration
  • mapbox-web-performance-patterns
  • mapbox-web-integration-patterns
  • mapbox-cartography
  • mapbox-style-patterns
  • mapbox-style-quality
  • mapbox-token-security
  • mapbox-ios-patterns
  • mapbox-android-patterns

Plus:

  • Skill-level AGENTS.md files for quick reference
  • Repo-level AGENTS.md for overview
  • Better documentation and examples

Migration Guide

Old (deprecated):

# These files are removed
.claude/skills/mapbox-cartography/

New (recommended):

npx add-skill mapbox/mapbox-agent-skills --skill mapbox-cartography

References

Removes skill directories from mcp-devkit-server and updates README to direct users to the official mapbox-agent-skills repository.

Changes:
- Removed all skill directories (mapbox-cartography, mapbox-integration-patterns, mapbox-style-patterns, mapbox-style-quality, mapbox-token-security)
- Updated skills/README.md to point to github.com/mapbox/mapbox-agent-skills
- Added installation instructions using npx add-skill
- Listed all 10 available skills in the dedicated repository
- Explained benefits of separate repository (maintenance, discoverability, versioning)

Why:
- Skills are better maintained in dedicated repository
- Easier discoverability via npx add-skill
- Independent versioning from MCP server
- More comprehensive collection (10 skills vs 5)
- Includes AGENTS.md files for persistent context
- Community can contribute more easily

Users should now install skills from mapbox-agent-skills repo:
npx add-skill mapbox/mapbox-agent-skills
@mattpodwysocki mattpodwysocki requested a review from a team as a code owner February 3, 2026 14:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant