map-shorts
AI agent skill: turn a narration into a fluid satellite-map animated vertical video (Shorts/Reels) - Python + Cairo + ffmpeg
Install / Use
npx skills add ozguryrr-design/map-shortsInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of map-shorts
map-shorts scores 81/100 on our quality scale, 3442nd of 4,698 Development & Engineering skills we index.
Its SKILL.md is 6.7 KB long, well organised into 9 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.
It has 2 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 6 days ago, so map-shorts is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-16. Automated pattern scan on 2026-11-16. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
map-shorts compared with similar skills
All 4 of these similar skills score higher than map-shorts; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| map-shorts (this skill)by ozguryrr-design | 81 | 2 | 6d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install map-shorts?
- Run
npx skills add ozguryrr-design/map-shorts. The install tabs above show the steps for each supported agent. - Which AI agents does map-shorts work with?
- It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is map-shorts safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is map-shorts still maintained?
- The repository was last updated 6 days ago, so map-shorts is actively maintained.
Skill content
View source on GitHubmap-shorts 🗺️🎬
Seslendirmeden profesyonel harita animasyonlu Shorts üreten yapay zekâ skill'i. An AI-agent skill that turns a narration into a fluid, satellite-map animated vertical video.
Uydu haritası, sinematik kamera uçuşları, 3D dünya, çizilerek beliren sınırlar, rotalar,
gemiler, bayraklar, sayaçlar, minimal başlıklar ve ses efektleri — hepsi kodla çizilir
ve ffmpeg ile 1080×1920 / 60 fps render edilir. Ajan (Claude, Gemini, GPT/Codex, …)
metni okur, sahne sahne görselleri planlar, scene.py yazar, kareleri kontrol eder ve
videoyu üretir.
Macellan–Elcano seferi (54 sn, tamamı ajan tarafından kodlandı ve render edildi):
<p align="center"><img src="docs/media/macellan_frames.jpg" width="100%" alt="Macellan örnek kareler"></p>Türkiye'nin gerçek boyutu (29 sn):
<p align="center"><img src="docs/media/turkiye_frames.jpg" width="100%" alt="Türkiye gerçek boyut örnek kareler"></p>Önizlemeler sessiz ve küçültülmüştür; gerçek çıktı 1080×1920, 60 fps, seslendirme + efektli MP4'tür.
| Örnek | Konu |
|---|---|
| examples/macellan | Macellan–Elcano seferi: dünya → İspanya, filo, Macellan Boğazı, Pasifik, Filipinler, dönüş, dünya turu finali |
| examples/turkiye_gercek_boyut | Türkiye'nin gerçek boyutu: Almanya/Teksas karşılaştırması, Mercator bozulması |
Kurulum / Install
Linux / macOS
git clone https://github.com/ozguryrr-design/map-shorts.git
cd map-shorts
bash scripts/setup.sh # Python venv, bağımlılıklar, Natural Earth verisi, fontlar
Gerekenler: Python 3.10+, ffmpeg, cairo kütüphanesi.
Windows (PowerShell, WSL gerekmez)
winget install Python.Python.3.12 # yoksa; python.org kurulumunda "Add python.exe to PATH" işaretleyin
git clone https://github.com/ozguryrr-design/map-shorts.git
cd map-shorts
powershell -ExecutionPolicy Bypass -File scripts\setup.ps1 -InstallFfmpeg
-InstallFfmpeg ffmpeg'i winget ile kurar (zaten kuruluysa atlanır). Cairo ayrıca kurulmaz:
pycairo Windows'ta hazır paket (wheel) olarak gelir. Microsoft Store Python'u yerine python.org /
winget Python'unu kullanın. Git Bash kullanıyorsanız bash scripts/setup.sh de çalışır.
Ajanınıza tanıtın / Register with your agent
Klasörün kendisi bir skill'dir (SKILL.md). Bu klasörü ajanınızın skill dizinine koyun / bağlayın:
| Ajan | Konum |
|---|---|
| Claude Code | ~/.claude/skills/map-shorts (veya proje içinde .claude/skills/map-shorts) |
| OpenAI Codex CLI | ~/.codex/skills/map-shorts — ya da depo içindeki AGENTS.md otomatik okunur |
| Google Antigravity | çalışma alanında .agents/skills/map-shorts |
| Gemini CLI, Cursor, diğerleri | depoyu açın ve ajana: "SKILL.md'yi oku ve uygula" deyin (AGENTS.md de yönlendirir) |
ln -s "$(pwd)" ~/.claude/skills/map-shorts # örnek (Linux/macOS)
# Windows (yönetici izni gerektirmeyen dizin bağlantısı)
New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
New-Item -ItemType Junction -Path "$HOME\.claude\skills\map-shorts" -Target (Get-Location)
Kullanım / Usage
Ajana sadece şunu söyleyin:
"Bu seslendirme metni için harita videosu hazırla: 20 Eylül 1519. Beş gemi…"
Seslendirmeniz varsa projects/<ad>/vo/voice.mp3 olarak verin; yoksa ajan geçici bir
yapay zekâ sesi ile çalışır, sesinizi sonra eklediğinizde animasyonlar kelimelere göre
otomatik yeniden hizalanır.
Elle kullanım:
.venv/bin/python make.py new benim_videom --text-str "Metin..."
.venv/bin/python make.py tts benim_videom # ya da: vo/voice.mp3 + make.py align
.venv/bin/python make.py sheet benim_videom # önizleme kontak sayfası
.venv/bin/python make.py final benim_videom # -> out/benim_videom.mp4
Windows'ta (PowerShell) .venv/bin/python yerine .venv\Scripts\python yazın:
.venv\Scripts\python make.py final benim_videom
Nasıl çalışır / How it works
mapengine/— Python + Cairo çizim motoru (Web Mercator, uydu karoları, van Wijk kamera uçuşları, ortografik dünya, deniz rotası A* bulucu, efektler, prosedürel ses, paralel/devam edebilen render).- Zamanlama kelimelere bağlıdır:
w("Pasifik")— ses değişse de sahne kaymaz. references/— ajan için API, stil rehberi ve sahne tarifleri.
Lisanslar / Credits
Varsayılan ayarlarla üretilen video para kazanılan kanallarda da kullanılabilir: uydu altlığı ticari kullanıma açık bir kaynaktan gelir ve gereken kaynak yazısı videoya otomatik eklenir.
Uydu altlığı seçenekleri (scene.py içinde TILE_PROVIDER)
| Değer | Kaynak | Lisans | Ticari kullanım | Not |
|---|---|---|---|---|
| "s2" (varsayılan) | EOxCloudless Sentinel-2, 2016 | CC BY 4.0 | ✅ kaynak yazısı videoda görünür olmalı | Şehir ölçeğine kadar iyi; 2016 görüntüsü |
| "nasa" | NASA Blue Marble (GIBS) | Kamu malı (NASA) | ✅ "NASA" kaynak olarak belirtilmeli | Düşük çözünürlük: dünya küresi / kıta görünümleri için |
| "esri" | Esri World Imagery | Esri kullanım şartları | ❌ yalnızca kişisel / ticari olmayan | En keskin görüntü; para kazanılan videoda kullanmayın |
- Kaynak yazısı otomatik: her karenin sol üst köşesine küçük, yarı saydam bir kaynak satırı
çizilir (Shorts arayüzünün ve başlıkların dışında). EOX'in CC BY şartı, videolarda kaynağın
videonun üzerinde görünmesini istediği için
"s2"ileATTRIBUTION = Trueaçık kalmalıdır. - Açıklama metni:
make.py finalayrıcaout/<ad>_credits.txtüretir; video açıklamasına yapıştırın (make.py credits <ad>ile ayrıca da alınabilir). "esri"seçilirse render sırasında ticari kullanım uyarısı basılır.- EOX'in 2017 ve sonraki yıllık katmanları ticari olmayan (CC BY-NC-SA) / ücretlidir; kod bilerek yalnızca CC BY 4.0 olan 2016 katmanını kullanır.
Diğer bileşenler
- Kod: MIT.
- Sınır verisi: Natural Earth (public domain).
- Font: Montserrat (SIL OFL). Bayraklar: flagcdn.com (ulusal bayraklar).
- Geçici ses (edge-tts) yalnızca taslak içindir: Microsoft Edge'in sesini resmî olmayan yoldan
kullanır. Yayınlamadan önce kendi sesinizi
vo/voice.mp3olarak koyupmake.py alignçalıştırın;credits.txtgeçici ses kullanıldıysa uyarır. Hizalama: faster-whisper (MIT).
Bu bölüm bilgilendirme amaçlıdır, hukuki tavsiye değildir. Lisans şartları değişebilir: EOxCloudless lisansı, NASA medya kullanım kuralları.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
