md-slidesyazan Alireza Rezvani

MD Slides Skill.

Q: Bu skill'i hangi kodlama ajanları çalıştırabilir?

Dosya, claude-code, codex-cli, cursor, antigravity, opencode ve gemini-cli'yi uyumlu araçlar olarak listeler; ayrıca markdown-html-orchestrator'ın bir girdiyi SLIDES olarak sınıflandırmasıyla da tetiklenebilir.

Q: Markdown'ımda belirgin slayt sınırları yoksa ne olur?

Skill tahmin etmek yerine reddeder ve 6 koduyla çıkar; belgelenen sonraki adım, bu dosyayı ayrık slaytlar yerine tek bir sürekli belgeyi işleyen md-document'a yönlendirmektir.

Q: Sunumdan PDF nasıl çıkarılır?

Yazdırma stil sayfasını kullanın: tarayıcıdan yazdırma, her sayfada bir slayt içeren bir PDF üretir, dolayısıyla dışa aktarma için ayrı bir araca gerek yoktur.

Claude Code ve Codex için PPT ve slayt sunumları skill'i: Markdown sunu dosyasını markalı slaytlara dönüştürür.

Presentations
HTML slaytları

OpenDesign İndir Kullanım kılavuzunu görüntüle

alirezarezvani/claude-skills · markdown-html/skills/md-slides/SKILL.mdSKILL.md

--- name: md-slides description: Converts a markdown deck (slides separated by `---` HR boundaries or by `# ` H1 headings, with optional `` presenter notes blocks) into a single-file HTML presentation with arrow-key / space / PgDn / PgUp / Home / End / P / Esc keyboard navigation, presenter mode (split view with current slide + speaker notes + clock + next-slide preview), URL-hash deep linking, and `@media print` page-per-slide … --- ## When to invoke ## Pipeline ## What ships in the HTML ## Hard rules ## Forcing-question library (Matt Pocock grill discipline) ## Distinct from

Yukarı akış dosyasından 2026-09-14 tarihinde okunan ön bilgi ve bölüm başlıkları · tam haliyle 6.506 karakter

01 Ne yapar

md-slides Skill'i Claude Code ve Codex'te Ne Yapar

Özet, iş akışı ve çıktılar; hepsi skill'in SKILL.md dosyasından okundu.

SKILL.md'den14-09-2026 tarihinde okundu · kayıtlı bir çalıştırma değil

Skill'in Kendi İfadeleriyle

md-slides, bir markdown destesini herhangi bir tarayıcıda çalışan tek dosyalık bir HTML sunuma dönüştürür. Deste, --- HR sınırlarıyla veya # H1 başlıklarıyla ayrılmış slaytlardan oluşur; isteğe bağlı  sunucu notu blokları içerebilir. Üç stdlib Python betiğinden oluşan bir işlem hattı: slide_splitter.py, presenter_notes_parser.py, deck_html_renderer.py.

Çıktı; klavye ile gezinme, URL-hash ile doğrudan bağlantı, bir ilerleme çubuğu ve slayt sayacı, saat ile sonraki slayt önizlemesi içeren sunum modu ve tek sayfada bir slayt olacak şekilde PDF dışa aktarımı için bir yazdırma stil sayfasıyla gelir. md-document'ın markdown ayrıştırıcısını yeniden kullanır ve config_loader.py üzerinden tasarım sistemi token'larını okur. Belirgin slayt sınırları olmayan girdileri, 1 slaytlık desteleri, 100 satırın altındaki dosyaları ve --strict-notes %50 kapsama koşulunu geçemeyen desteleri reddeder.

Neler üretir

Çözümlenen varsayılan çıktı dizininde deck-{slug}.html olarak yazılan, çakışmalarda sonuna -2, -3 vb. eklenen, oluşturulmuş HTML deste.
Bölünmüş slaytları ve ardından eklenmiş notlarıyla birlikte slaytları tutan ara JSON dosyaları.
Yazdırma stil sayfası aracılığıyla tarayıcıdan yazdırılarak üretilen, sayfa başına bir slayt içeren bir PDF.

Örnek istemi görün ↗

Nasıl Çalışır

01
Desteyi Sıralı Slaytlara Bölme
slide_splitter.py, kaynak markdown'ı okur ve --- HR satırlarında veya H1 başlıklarında böler; varsayılan olarak sınır stilini otomatik algılar ve sıralı bir slayt listesi yazar.
02
Slayt Başına Sunucu Notları Ekleme
presenter_notes_parser.py her slaytı notu blokları için tarar ve bunları ilgili slayta ekler, böylece sunum modunda sağ paneli gösterecek bir içerik olur.
03
Tek Dosyalık HTML Desteyi Oluşturma
deck_html_renderer.py, slaytları tasarım sistemi token'larıyla birleştirir ve desteyi üretir; komut satırında bir başlık ve bir çıktı yolu alır.
04
Tasarım Sistemi Token'larını Uygulama
On iki marka CSS özel özelliği tasarım sisteminden gelir ve design_style, slayt düzenlerinin ne kadar yoğun olduğunu değiştirir.
05
Sunum Olmayan Girdileri Reddedin
Girdide belirgin slayt sınırları yoksa, tek bir slaytla sonuçlanacaksa veya --strict-notes altında notes-coverage eşiğini geçemiyorsa skill dönüştürme yapmak yerine çıkış yapar.

02 Uyumunuzu bulun

md-slides Skill Ne Zaman Kullanılır

İş PPT ve bu tür slayt sunumları olduğunda Claude Code veya Codex'te md-slides skill'ini kullan. Aşağıdaki uygunluk ve sınırlar skill'in kendi dosyasından alınmıştır.

İyi Uyum

Bir orkestratör girdiyi SLIDES olarak sınıflandırdı ve buraya yönlendirdi.
Biri, slash komutuyla skill'i doğrudan bir markdown dosyasında çağırır.
Markdown'da zaten 3 veya daha fazla --- HR satırı, ya da kısa gövdeli 5 veya daha fazla H1 başlığı vardır.
Sunum canlı olarak yapılacaktır; bu, konuşmacı notlarının önemli olduğu ve kendi hızında okumanın onları isteğe bağlı kıldığı tam da o durumdur.

Sınırları Bilin

Girdi bir sunum değil, uzun biçimli bir spesifikasyondur; bu md-document'a gitmelidir.
Girdi bir kod incelemesidir ve md-review'a aittir.
Bu bir grafik tasarım aracı değildir: Keynote ve PowerPoint o alana sahiptir, bu ise bir tarayıcıdan yansıtılan markdown tabanlı sunumları ele alır.

Ne Sağlamalısınız

Markdown sunum dosyasıYolu, --input ile slide_splitter.py'ye iletilir ve bölme sonucu --output ile bir JSON dosyasına yazılır.
Sınır stiliSlaytlar, ayırıcının üzerinde kesim yapabilmesi için --- HR sınırları veya H1 başlıklarıyla birbirinden ayırt edilebilir olmalıdır.
İsteğe bağlı konuşmacı notlarıNotlar, slaytların içinde HTML yorum blokları olarak verilir ve ikinci pipeline adımında ayrıştırılıp her slayta eklenir.

03 Skill'in içinde

md-slides Skill'inin Claude Code ve Codex'e Verdiği Kurallar

SKILL.md'nin ajan için belirlediği 8 somut talimat, varsayılan ve sınır — dosyanın sonucu değiştiren kısmı.

Sınır Gereksinimi
Otomatik mod, kaynakta en az 3 HR satırı veya en az 5 H1 başlığı gerektirir; hiçbiri yoksa skill reddeder ve girdi bunun yerine md-document'a gitmelidir.
Tek Slaytlık Çıkış Yok
Tek bir slayta dönüşen bir sunum, çıkış kodu 5 ile bir afiş olarak kabul edilir, sunum olarak değil.
En Az 100 Kaynak Satırı
100 satırdan kısa girdiler, tüm dönüştürücülerde uygulanan aynı Shihipar eşiği kullanılarak reddedilir.
Kurulum Kapısı
Skill, kurulum (onboarding) tamamlanmadan çalışmayı reddeder; bu, her dönüştürücünün kullandığı aynı kapıdır.
Sıkı Not Kapsamı
--strict-notes ile skill, slaytların %50'sinden azında not bulunan bir sunumu reddeder, çünkü sunucu modu için yapılandırılmamıştır; bu reddetme 7 ile çıkış yapar.
Çok Uzun Slaytlarda Uyar
40 satırdan uzun kaynak satırlar sinyal-gürültü konusunda hafif bir uyarı üretir; slayt takımı yine de render edilir ancak sayı görünür kılınır.
Çıktıyı Tek Dosya Olarak Tutun
Tüm CSS ve JS satır içidir; tek dış kaynak Google Fonts CSS'idir ve Prism.js varsayılan olarak paketlenmez, --syntax üzerinden isteğe bağlı olarak eklenir.
Framework Çalışma Zamanı Yok
Slayt takımı, React, Vue veya Svelte çalışma zamanı olmadan sadece vanilla JS ve klavye olay işleyicileri kullanır.

04 İşe koyun

md-slides ajanını Claude Code veya Codex içine kurun

Bir npx skills add komutu, ardından ajanınızda ilk görev ve sonuç için bir kontrol listesi.

md-slides ajanını Claude Code, Codex veya Kendi Ajanınıza ekleyin

Projenizde çalıştırın; kurulum aracı, bunun hangi ajana ekleneceğini sorar.

Terminal

npx skills add https://github.com/alirezarezvani/claude-skills --skill md-slides

markdown-html/skills/md-slides/SKILL.md için genel skills CLI formu; depo kendi yolunu belgeleyebilir.

Beceriye İlk PPT ve Slayt Sunumu Görevini Verin

Skill'in kendi terimleriyle yazıldı; köşeli parantezli bölümleri kendi malzemenizle değiştirin.

Starter prompt

Convert [deck.md] into a presentation. It uses --- HR boundaries for slides and each slide has a <!-- notes: ... --> block. Title it "[Talk title]" and run it with --strict-notes, since it will be presented live rather than read on its own. Write the result to [output/deck.html].

Kaynak: SKILL.md'den, skill'in kendi terimleriyle yazıldı.

İlk Sonucu Kontrol Edin

SKILL.md'nin doğru bir sonucun nasıl göründüğüne dair söyledikleri:

Slayt takımını bir tarayıcıda açın ve tuşları deneyin: ok tuşları, Space ve PgDn ileri, PgUp geri gider, Home ve End atlar, P sunucu modunu açar/kapatır, Esc çıkar.
Derin bağlantıyı test edin: #3, 3. slayta atlamalı, tarayıcı geri ve ileri düğmeleri slaytlar arasında gezinmeli ve paylaşılan bir deck.html#5 doğrudan 5. slaytta açılmalıdır.
Sağ alt köşedeki, "3 / 12" gibi görünen slayt sayacını slayt takımının uzunluğuna göre kontrol edin.
Azaltılmış hareket medya sorgusuna uyulduğunu, yani daha az hareket isteyen izleyiciler için animasyonun kaldırıldığını doğrulayın.

OpenDesign içinde md-slides'ı SKILL.md bağlantısından içe aktarın: Plugins → Add → Skill → Import from link, ardından üst çubuktan seçin.

OpenDesign İndir Hızlı başlangıcı okuyun

05 Açık kaynak, izlenebilir

Kaynak, Lisans ve Doğrulama

Bu sayfadaki bilgilerin nereden geldiği ve en son ne zaman kontrol edildiği.

Author: Alireza Rezvani
Repository: github.com/alirezarezvani/claude-skills Dal main
Skill dosyası: markdown-html/skills/md-slides/SKILL.md Doğrulama sırasında içerik sağlama toplamı kaydedildi; commit 19392f7
License: MIT LICENSE dosyasından.
Repository yıldızları: 25.934 GitHub anlık görüntüsü 2026-09-14 tarihinde, bu katalogda 5 skill içeren tüm alirezarezvani/claude-skills deposu için alındı. md-slides için bir derecelendirme veya kullanım sayısı değildir.
OpenDesign tarafından doğrulandı: 2026-09-14 Kaynak dosya, yol, lisans metni ve yıldız sayısı kontrol edildi. OpenDesign ana sürümünde dahil değil (2026-08-28 kontrol edildi); bu sayfada canlı bir çalıştırma kaydedilmedi.

SKILL.md içinde

Ne zaman çağrılırYönlendirme belirtileri ve hangi girdilerin reddedilmesi veya başka yere gönderilmesi gerektiği.
Boru hattıBölen, notları ayrıştıran ve slayt takımını render eden üç komut.
HTML içinde neler varGezinme, derin bağlantı, sunucu modu, yazdırma stil sayfası, tokenlar, ayrıştırıcı yeniden kullanımı.
Kesin kurallarReddetme eşikleri, hafif uyarılar ve tek dosya çıktı kısıtlamaları.
Zorlayıcı soru kitaplığı (Matt Pocock sorgulama disiplini)Bir kaynak dosyayı dönüştürmeden önce çözülmesi gereken beş soru.
Şundan farklıdırmd-document, md-review, açılış sayfaları, Keynote'tan nasıl farklılaştığı.
Çıktı üretimiÇıktı yolu çözümlemesi ve çakışma soneki kuralı.
KaynaklarSlayt takımı kurallarının arkasındaki kaynaklar ve referanslar.

Skill'in Kendi Açıklaması

"Markdown sunumunu (`---` yatay çizgi sınırları veya `# ` H1 başlıkları ile ayrılmış slaytlar, isteğe bağlı `` sunum notu blokları ile) ok tuşu / boşluk / PgDn / PgUp / Home / End / P / Esc klavye navigasyonu, sunum modu (mevcut slayt + konuşmacı notları + saat + sonraki slayt önizlemesi ile bölünmüş görünüm), URL-hash derinlemesine bağlantı ve PDF dışa aktarma için `@media print` sayfa-başına-slayt ile tek dosya HTML sunumuna dönüştürür. Markdown-html-orchestrator bir girdiyi SLIDES olarak sınıflandırdığında veya doğrudan /cs:md-slides ile çağrıldığında tetiklenir. Slayt gövdesi render etmek için md-document'in markdown parser'ını yeniden kullanır ve config_loader.py aracılığıyla design-system token'larını okur. Girdide net slayt sınırları yoksa, 1 slaytlık sunum üretiyorsa veya `--strict-notes` açık ve < %50 not kapsamı varsa reddeder. Orchestrator yönlendirmesinden sonra kullanın."

SKILL.md dosyasından ön bilgi açıklaması. Tam dosya yaklaşık 6.506 karakterdir. Tam dosyayı GitHub'da okuyun.

06 Kurmadan önce

md-slides Skill Hakkında Sorular

Yanıtlar, 2026-09-14 tarihinde okunan SKILL.md üzerinden alınmıştır, kaydedilmiş bir çalıştırmadan değil.

Bu skill'i hangi kodlama ajanları çalıştırabilir?

Dosya, claude-code, codex-cli, cursor, antigravity, opencode ve gemini-cli'yi uyumlu araçlar olarak listeler; ayrıca markdown-html-orchestrator'ın bir girdiyi SLIDES olarak sınıflandırmasıyla da tetiklenebilir.

Markdown'ımda belirgin slayt sınırları yoksa ne olur?

Skill tahmin etmek yerine reddeder ve 6 koduyla çıkar; belgelenen sonraki adım, bu dosyayı ayrık slaytlar yerine tek bir sürekli belgeyi işleyen md-document'a yönlendirmektir.

Sunumdan PDF nasıl çıkarılır?

Yazdırma stil sayfasını kullanın: tarayıcıdan yazdırma, her sayfada bir slayt içeren bir PDF üretir, dolayısıyla dışa aktarma için ayrı bir araca gerek yoktur.

MD Slides

md-slides ajanını Gerçek Bir PPT ve Slayt Sunumları Görevi üzerinde çalıştırın.

OpenDesign'ı indirin, md-slides'ı SKILL.md bağlantısından içe aktarın, yukarıdaki prompt'u yapıştırın ve sonuçtan önce planı okuyun.

OpenDesign'ı İndirin Tüm skill'lere göz atın