MapLibre 애플리케이션을 구축하는 AI 어시스턴트를 위한 큐레이션된 가이드 — 생태계 및 오픈 소스(open-source) 베스트 프랙티스를 다룹니다.
에이전트 스킬(Agent skills)은 AI 코딩 어시스턴트가 컨텍스트(context)로 읽는 마크다운(markdown) 파일입니다. AI 에이전트에게 MapLibre를 사용하여 무언가를 구현하도록 요청할 때, 이러한 스킬들은 AI가 흔한 API 실수(gotchas)를 피하고 제대로 작동하는 패턴을 제안할 수 있는 판단력을 제공합니다.
새로운 스킬은 정기적인 수요 마이닝(demand mining)을 기반으로 우선순위가 결정됩니다 — 이는 GitHub 이슈, Stack Overflow, 그리고 커뮤니티 Slack에 기록된 AI의 실패 사례를 추적하는 방식입니다. 각 스킬은 실제 개발자 질문에 대한 AI의 응답을 개선하는지 확인하기 위해 Promptfoo 평가(evals)로 테스트됩니다.
| 스킬 | 사용 시점 |
|---|
maplibre-tile-sources | 지도 데이터를 공급하는 방법 선택; GeoJSON과 타일(tiles) 사이의 결정; 베이스맵(basemap) 구성; 빈 지도 또는 누락된 레이블 디버깅 |
maplibre-pmtiles-patterns | 타일 서버 없이 타일 호스팅; 정적 또는 서버리스(serverless) 배포; MBTiles에서 변환; OSM 또는 GeoJSON에서 타일 생성 |
maplibre-mapbox-migration | 기존 Mapbox GL JS 앱을 MapLibre로 이전; 오픈 소스 대안으로서 MapLibre 평가 |
각 스킬은 skills/<skill-name>/ 아래에 위치합니다.
:
SKILL.md— 필수 사항. YAML 프론트매터(front-matter) (name, description) 및 마크다운 콘텐츠가 포함됩니다. AGENTS.md— 선택 사항. LLM을 위한 짧은 참조용.
스킬을 추가하거나 개선하려면 CONTRIBUTING.md를 참조하세요. 모든 숙련도의 참여를 환영하지만, MapLibre 개발에 대한 생성형 AI(genAI)의 기본 기여도를 개선하려는 목적이므로, AI 에이전트에 의해 전적으로 생성된 스킬이나 기여는 거절될 가능성이 높다는 점을 유의해 주세요.
프로젝트에 스킬을 설치하면 작업을 설명할 때 AI 어시스턴트가 자동으로 이를 가져오므로, 매번 수동으로 컨텍스트를 정의할 필요가 없습니다.
스킬은 일반 마크다운입니다.
채팅에 붙여넣기: 위의 SKILL.md 중 아무거나 열어서 AI 어시스턴트의 컨텍스트 창에 직접 붙여넣으세요. 프로젝트에 복사: SKILL.md를 .claude/skills/, .cursor/rules/에 넣거나 .github/copilot-instructions.md에 추가하세요.
.로컬 개발을 위한 심볼릭 링크 (Symlink):
mkdir -p .claude
ln -s /path/to/maplibre-agent-skills/skills .claude/skills
skills CLI는 AI 에이전트 스킬 (agent skills)을 위한 패키지 매니저입니다. 사용 중인 도구에 맞춰 스킬 파일들을 적절한 위치에 자동으로 배치하며, 40개 이상의 에이전트 (agents)를 지원합니다.
# 사용 가능한 스킬 목록 확인
npx skills add maplibre/maplibre-agent-skills --list
# 모든 스킬 설치
...
기본적으로 스킬은 프로젝트 단위로 설치됩니다. 전역적으로 (예: 사용자 프로필에) 설치하려면 다음과 같이 입력하세요:
npx skills add maplibre/maplibre-agent-skills -g
특정 에이전트용으로 설치하려면 다음과 같이 입력하세요:
npx skills add maplibre/maplibre-agent-skills -a claude-code
npx skills add maplibre/maplibre-agent-skills -a cursor
npx skills add maplibre/maplibre-agent-skills -a vscode
전체 목록은 지원되는 에이전트 (Supported Agents) 섹션을 참조하세요.
설치가 완료되면 다음 명령어로 스킬을 관리할 수 있습니다:
| 명령 (Command) | 설명 (Description) |
|---|
npx skills list | 설치된 스킬 목록 표시 (별칭: ls) |
npx skills find [query] | 대화형 또는 키워드로 스킬 검색 |
npx skills remove [skills] | 에이전트에서 설치된 스킬 제거 |
npx skills check | 사용 가능한 스킬 업데이트 확인 |
npx skills update | 모든 설치된 스킬을 최신 버전으로 업데이트 |
npx skills init [name] | 새로운 SKILL.md 템플릿 생성 |
MIT License. Copyright (c) MapLibre and contributors. 자세한 내용은 LICENSE.md 및 NOTICE를 참조하세요.