Teknik kitaplar ajan yeteneğine nasıl dönüştürülür?
PDF, EPUB veya doküman klasörlerini kodlama ajanınız için optimize edilmiş yeteneklere dönüştürün. Token bütçesi, headless çalıştırma ve lisanslama detaylarını öğrenin.
Teknik bir kitabı ajan yeteneğine dönüştürmek: elde edecekleriniz
Bir teknik kitabı ajan yeteneğine dönüştürmek için dönüştürücüyü bir PDF, EPUB, DOCX dışa aktarımı veya halihazırda sahip olduğunuz dahili belgelerden oluşan bir klasöre yönlendirirsiniz. Araç bir yetenek dizini oluşturur: adlandırılmış çerçeveleri ve bölümlerin dizinini içeren bir giriş dosyası ile ajanın yalnızca sorunuz gerektirdiğinde okuyacağı bölüm başına bir dosya. Kitabın tamamı bağlam penceresine (context window) girmez. Yalnızca dizin girer.
Bu işlem, halihazırda bildiğiniz bir prosedürü kodladığınız sıfırdan ajan yeteneği yazma sürecinin tam tersidir. Burada bilgi zaten mevcuttur ancak kimse ona erişememektedir: 800 sayfalık bir üretici PDF'i veya yazan kişi ayrıldığından beri açılmamış bir el kitabı gibi. Yapılan iş sıkıştırma ve indekslemedir. Eğer yetenek (skill) terimi sizin için yeniyse, önce ajan yeteneğinin gerçekte ne olduğu konusunu okuyun.
Burada kullanılan dönüştürücü, kendi makinenizde çalışan MIT lisanslı bir yetenek olan book-to-skill'dir. Ekim 2026 itibarıyla güncel etiket v1.4.0'dir. Oluşturduğu yapı, aracın kendisinden daha önemlidir ve FAQ bölümünden önceki son kısım, aynı yapının elle nasıl oluşturulacağını göstermektedir.
Token bütçesi neden tüm tasarımın temelidir
Bir bağlam penceresine yapıştırılan kitap, ihtiyaç duyulan her görüşmede tam boyutu kadar maliyet oluşturur. Bir beceri (skill), giriş dosyasının maliyetini bir kez, soru tarafından gerçekten tetiklenen bölümlerin maliyetini ise ayrıca yansıtır. Proje, oluşturduğu her dosya için bir bütçe tanımlar.
Bu grafiğin arkasındaki veriler
[
{
"label": "SKILL.md entry file",
"tokens": "4,000"
},
{
"label": "One prose chapter at reference depth",
"tokens": "1,000"
},
{
"label": "glossary.md",
"tokens": "1,500"
},
{
"label": "patterns.md",
"tokens": "2,000"
},
{
"label": "cheatsheet.md",
"tokens": "1,200"
}
]Giriş dosyası olan SKILL.md, 4,000 token ile sınırlandırılmış olup adlandırılmış çerçeveleri ve bölüm dizinini içerir. Referans derinliğindeki bir düz yazı bölümü yaklaşık 1,000 token hedefler ve birisi talep edene kadar diskte bekler; teknik bölümler ve çalışma derinliği, bölüm başına 3.000 tokene kadar çıkan daha yüksek hedeflere sahiptir. Destekleyici dosyalar da benzerdir: glossary.md için 1,500 token, patterns.md için 2,000 token, cheatsheet.md için 1,200 token.
Bu bütçeler, Claude Code'un bağlamı gerçekte nasıl harcadığıyla uyumludur. Bir becerinin adı beceri listesinde kalır, ancak liste bütçesini aştığında açıklaması çıkarılabilir. Gövde kısmı, beceri çağrıldığında yüklenir ve sıkıştırma bütçesine tabi olarak sonraki görüşme turlarında konuşmada kalır; bu nedenle giriş dosyasındaki her satır yinelenen bir maliyettir. Destekleyici dosyalar yalnızca aracı (agent) onları okuduğunda yüklenir; bölüm bazlı dosyaları ucuz kılan da budur.
Giriş dosyası rakamının arkasında daha katı bir sınır bulunur. Otomatik sıkıştırma uzun bir görüşmeyi özetlediğinde, Claude Code her becerinin en son çağrılma anını özetin arkasına yeniden ekler ve her birinin ilk 5.000 tokenini, tüm yeniden eklenen beceriler için toplam 25.000 tokenlik bir bütçe içinde tutar. Birleşik bütçe, en son çağrılan becerilere öncelik verir, bu nedenle 5.000 tokenin altındaki bir giriş dosyası bile tamamen çıkarılabilir. Yeniden eklenen 20.000 tokenlik bir giriş dosyası, ilk çeyreği kadar geri döner.
Bu, aşamalı bir ifşadır: her zaman maliyetine değen küçük bir dizin ve aracın bilerek açtığı bir kapının ardında duran materyal yığını. Claude Code bağlam penceresini nasıl yönetir konusu, bu hesaplamanın geri kalanını kapsar.
Converter'ı VPS'nize kurun ve belirli bir sürüme sabitleyin
Bu yetenek bir git deposudur. Kullandığınız ajanın yetenekler dizinine klonlayın. Dizin adı slash komutu haline gelir, bu nedenle klonlama yolu keyfi değildir.
git clone --depth 1 --branch v1.4.0 \
https://github.com/virgiliojr94/book-to-skill.git \
~/.claude/skills/book-to-skill--branch bir etiket kabul eder, bu nedenle bu komut v1.4.0 sürümünü ve sonrasını değil, yalnızca belirtileni kontrol eder. Sabitleme yapın; çünkü bir yetenek, ajanınızın izlediği talimatlar bütünüdür ve bu talimatlarda gözden geçirilmemiş bir değişiklik, sunucunuzda çalışan şeyin değişmesi anlamına gelir. GitHub Copilot CLI bunun yerine ~/.copilot/skills/ okur, Amp ise ~/.agents/skills/ okur.
Ayrıca, güncel olan her şeyi çeken tek satırlık bir kurulum komutu olan npx skills add virgiliojr94/book-to-skill de mevcuttur. Aracı denemek için bunu kullanın. Tekrar çalıştırdığınız her şey için sabitlenmiş klonlamayı kullanın.
Şimdi sunucuda hangi çıkarıcıların (extractor) bulunduğunu doğrulayın:
cd ~/.claude/skills/book-to-skill
python3 scripts/extract.py --check--check, hangi çıkarıcıların yüklü olduğunu raporlar ve eksik olanlar için neyin yüklenmesi gerektiğini yazdırır: eksik Python paketleri için birleştirilmiş bir pip komutu ve her eksik sistem aracı için bir ipucu. Paket, Python 3.9 veya daha yeni bir sürüm gerektirir.
Eğer /book-to-skill klonlamadan sonra otomatik tamamlama içinde görünmezse, /reload-skills komutunu çalıştırın veya ajanınızı yeniden başlatın. Claude Code, oturum başladığında mevcut olan yetenek dizinlerini izler; bu nedenle iki dakika önce oluşturduğunuz bir ~/.claude/skills/ henüz izlenmiyor olabilir.
Gerçekten hangi çıkarıcılara ihtiyacınız var?
Düz metin ve diğer birçok format yalnızca Python gerektirir, ancak PDF'ler için bir çıkarıcı, MOBI ve AZW dosyaları için ise Calibre gerekir. Yedek yöntemler daha verimsizdir ve küçük bir sunucuda, kullanmadığınız çıkarıcıları yükleyerek vakit kaybetmemelisiniz.
pdftotext,poppler-utilspaketinden gelir, metin ağırlıklı PDF'leri işler ve neredeyse anlıktır.sudo apt install poppler-utilsile yükleyin.pypdfvepdfminer.six, PDF için Python yedekleridir.docling, değeri tablolarında ve kod listelerinde olan teknik PDF'ler içindir. Proje, sayfa başına yaklaşık 1,5 saniyelik bir işlem süresi öngörmektedir.beautifulsoup4ile birlikteebooklib, EPUB dosyalarını düzgün bir şekilde okur. Bunlar olmadan araç, standart kütüphane olanzipfileokuyucusuna geri döner.python-docx, DOCX dosyalarını;striprtfise RTF dosyalarını okur.- MOBI ve AZW dosyaları için Calibre'nin
ebook-convertaracı gereklidir. ocrmypdf, hiçbir metin katmanı içermeyen taranmış kitaplar üzerinde OCR (optik karakter tanıma) çalıştırır.
Ubuntu 24.04 üzerinde düz bir pip3 install pypdf komutu şu hata ile durur:
error: externally-managed-environmentBu, bozuk bir pip değildir. Ubuntu ve Debian, sistem Python'unu apt tarafından yönetilen bir yapı olarak işaretler, bu nedenle pip buraya yazmayı reddeder. İki çözüm işe yarar. sudo apt install poppler-utils bir binary yükler ve pip gerektirmez; pdftotext ise çoğu düz metin PDF'ini kendi başına işleyebilir. Python çıkarıcıları için bir sanal ortam oluşturun ve aracınızı bu ortamın içinden başlatın; böylece yeteneğin çağırdığı python3, paketlerin yüklü olduğu yorumlayıcı olur.
python3 -m venv ~/.venvs/book-to-skill
source ~/.venvs/book-to-skill/bin/activate
pip install "$HOME/.claude/skills/book-to-skill[pdf,epub,docx]"
claudeSabitlenmiş v1.4.0 checkout'u, pdf, epub, docx, rtf, technical ve all ekstralarını bildirir; burada technical, docling'dır. Projenin kurulum sayfası, doğrudan GitHub üzerinden yapılan bağımsız bir komut satırı kurulumunu da belgeler: pip install "book-to-skill[pdf,epub,docx] @ git+https://github.com/virgiliojr94/book-to-skill.git", ardından yüklü çıkarıcıları listelemek için book-to-skill --check. Bu, PyPI sürümü gerektirmez ancak v1.4.0 yerine projenin varsayılan dalını yükler ve size /book-to-skill yeteneğini değil, yalnızca çıkarıcı komutunu verir. Sabitlenmiş bir kurulum için yukarıdaki gibi kendi checkout'unuzdan yükleyin. Ekim 2026 itibarıyla bu isim PyPI üzerinde yayınlanmadığı için, sadece pip install book-to-skill komutu çalışmaz.
Bir kitap ihtiyaç duyana kadar docling aracını yüklemeyin. Bir makine öğrenimi yığını gerektirir, bu nedenle yüklemeden önce küçük bir plandaki boş disk alanını kontrol edin.
Belgelerden oluşan bir klasör üzerinde, headless mod dahil olmak üzere çalıştırma
Komut; bir dosya, bir klasör, tırnak içinde bir glob ifadesi veya aynı anda birden fazla yol ve ardından isteğe bağlı bir yetenek (skill) adı alır. Tek bir dizine koyabileceğiniz her şey çalışır; buna RFC (internet protokollerini tanımlayan belgeler olan "request for comments") seti de dahildir.
/book-to-skill ~/library/platform-docs/ platform-handbook
/book-to-skill "~/books/*.epub" my-library
/book-to-skill ~/papers/paper1.pdf ~/notes/export.txt unified-researchShell'in yetenek görmeden önce genişletmemesi için glob ifadesini tırnak içine alın. Komutu mevcut bir yetenek dizinine yönlendirmek, ikinci bir yetenek oluşturmak yerine yeni kaynakları mevcut yeteneğe dahil eder.
Etkileşimli bir çalıştırma size sorular sorar. Materyalin teknik mi yoksa metin ağırlıklı mı olduğu, çıkarıcıyı (extractor) belirler. Yeteneğin size ne konuda yardımcı olması gerektiği, referans veya çalışma derinliğini ve bununla birlikte bölüm başına bütçeyi ayarlar. Yeteneğin adının ne olması gerektiği ve henüz bir yetenek kökü yoksa veya birden fazla kök varsa, hangisine yerleştirilmesi gerektiği sorulur. Ayrıca oluşturma işleminden önce bir token ve süre tahmini yazdırır ve onayınızı bekler.
Headless bir çalıştırmada bu soruları yanıtlayacak kimse yoktur. Kullanıcı tarafından çağrılabilen yetenekler claude -p içinde çalışır: slash komutunu istem dizisine koyun; Claude Code çalıştırma başlamadan önce bunu genişletir. Bu nedenle soruları aynı istemde yanıtlayın.
claude -p "/book-to-skill ~/library/platform-docs/ platform-handbook
The sources are technical. Use reference depth. Write the skill to
~/.claude/skills/. Do not publish it to GitHub. Proceed without asking me." \
--allowedTools "Bash,Read,Write,Edit"--allowedTools, çalıştırmanın ihtiyaç duyduğu araçları önceden onaylar; izin sunucusu olmayan normal bir claude -p çalıştırmasında, hala onay gerektiren çağrılar reddedilir. --output-format json eklemek, total_cost_usd sonucunu dahil eder; bu, faturanızdan ziyade istemci tarafında bir tahmindir.
Çıkarma işlemi, herhangi bir model okumadan önce her kaynağı /tmp altındaki geçici bir çalışma dizininde birleştirir ve çalıştırmanın son adımı bu dizini siler. Çıkarılamayan bir kaynak atlanır, böylece toplu işlem devam eder; bu, bir çalıştırmanın sağladığınızdan daha az dosya okuyarak başarı rapor edebileceği anlamına gelir. Nihai rapordaki dosya envanterini klasördekiyle karşılaştırın. Eksik bir bölüm genellikle eksik bir kaynaktır.
Çalıştırmaya, bir araca teslim etmekten çekinmeyeceğiniz bir sunucu verin. Claude Code'u bir VPS üzerinde güvenli bir şekilde çalıştırma konusu, işin izin tarafını kapsar.
Çıktının kodlama aracınız tarafından bulunması için nereye gittiği
Oluşturulan yetenek, bir yetenek kök dizinine yerleşir. Bunlardan ikisi önemlidir.
~/.claude/skills/<skill-name>/kişiseldir ve o makinedeki her projede kullanılabilir..claude/skills/<skill-name>/bir deponun içinde yer alır ve onunla birlikte taşınır.
Her ikisinin içinde SKILL.md, bölüm başına bir dosya içeren bir chapters/ dizini ve destekleyici dosyalar bulunur. Dizin adı komuttur, bu nedenle ~/.claude/skills/platform-handbook/ size /platform-handbook komutunu verir ve ardından bir konu veya basit bir soru ile devam edebilirsiniz.
Kök dizini kolaylığa göre değil, lisanslamaya göre seçin. Satın aldığınız bir kitaptan oluşturulan yetenek, kişisel dizininize aittir. Kendi ekibinizin yazdığı belgelerden oluşturulan bir yetenek ise depoya aittir; bu da bir yeteneğin birden fazla depo arasında paylaşılması konusunu çözülmesi gereken bir sonraki sorun haline getirir.
Her yetenek eklediğinizde bir maliyet artar. Her yetenek adı listede kalır, ancak liste bütçesini aştığında açıklamalar kaldırılır; her girdinin birleşik description ve when_to_use metni varsayılan olarak 1.536 karakterle sınırlandırılmıştır. On kitap yeteneği, on açıklamanın bunun için rekabet etmesi anlamına gelir. Her zaman adıyla çağırdıklarınız için, oluşturulan ön metne (frontmatter) bir satır ekleyin:
---
name: platform-handbook
description: Frameworks and chapter index from the internal platform handbook.
disable-model-invocation: true
---disable-model-invocation: true ile açıklama bağlamın tamamen dışında tutulur ve /platform-handbook yazdığınızda yetenek yine de tam olarak yüklenir. Otomatik keşfetme özelliğinden vazgeçer ve daha sade bir bağlam penceresi elde edersiniz.
Lisanslama: MIT, dönüştürücüyü kapsar, kitabı değil
Bu konuda kesin olun, çünkü buradaki başarısızlık teknik bir durum değildir.
- MIT lisansı, dönüştürücünün kodunu ve beceri tanımını kapsar. İçine beslediğiniz belge hakkında hiçbir şey söylemez.
- Satın aldığınız bir kitabı, kontrolünüz altındaki donanım üzerinde dönüştürücüden geçirmek, kendi kopyanızdan notlar almanız anlamına gelir.
- Sonucu yayınlamak dağıtımdır ve araç üzerindeki MIT lisansı, başkasının kitabından türetilen herhangi bir şeyi dağıtma hakkı vermez.
- Çıktı, türev bir çalışmadır. Çerçeveler ve bölüm özetleri hala kaynak tarafından şekillendirilir ve türev bir çalışma, kaynağın telif hakkı yasalarına tabidir.
- Yeniden dağıtamayacağınız materyalden oluşturulan bir beceri, onu oluşturan makinede kalmalıdır. Herkese açık bir depoda veya paylaşılan bir ekip pazarında değil.
- Kaynak size aitse veya açık lisanslıysa yayınlayın: ekibinizin yazdığı belgeler veya şartları yeniden dağıtıma izin veren bir standart gibi.
Araç bu temel üzerine inşa edilmiştir. Kitap içeriği barındırmaz ve ayıklama işlemi yerel olarak çalışır. Sabitlenmiş v1.4.0 yalnızca isteğe bağlı bir gh skill publish satırı yazdırır ve görünürlük hakkında asla soru sormaz, bu nedenle karar tamamen size aittir. Projenin varsayılan dalı, o zamandan beri depo görünürlüğünü ayrı bir tek kelimelik soru olarak soran ve yalnızca yanıt public kelimesi olduğunda herkese açık bir depo oluşturan bir yayınlama adımı eklemiştir; başka herhangi bir yanıt depoyu özel tutar. Ayrıca depo oluşturulmadan önce yeniden dağıtım haklarını kontrol eder ve üçüncü taraf telif hakkı olan kitaplardan alınan becerileri özel tutar. Bu adımı lisanslama kararı olarak değerlendirin, çünkü gerçekte olan budur.
Kurum içi el kitapları ikinci bir sorun teşkil eder. Kimsenin kabul ettiğinden daha sık kimlik bilgileri içerirler ve bir dönüştürücü, kimsenin açmadığı bir PDF'i temsilcinizin talep üzerine okuduğu bir dosyaya dönüştürür. Oluşturulan dosyaları commit etmeden önce bir kez okuyun ve yapay zeka temsilcilerinizden sırları uzak tutma konusuna göz atın.
Bir dönüştürme işleminin maliyeti nedir?
Aşağıdaki rakamlar, bizim tarafımızdan değil, ölçülen token sayıları üzerinden hesaplanmış ve projenin kendi yayınladığı tahminlerdir.
Bu grafiğin arkasındaki veriler
[
{
"label": "Think Python 2",
"cost_usd": 0.88
},
{
"label": "Working Backwards",
"cost_usd": 0.96
},
{
"label": "Pro Git",
"cost_usd": 1.23
},
{
"label": "Moby-Dick",
"cost_usd": 1.42
}
]Projenin ölçüm yaptığı 4 kitap genelinde, tahmini dönüştürme maliyeti 0.88 ile 1.42 ABD doları arasında değişmektedir; Pro Git için bu tutar 1.23 seviyesindedir. Rakamlar, Claude Sonnet 4.5 fiyatlandırması kullanılarak ölçülen token sayıları üzerinden hesaplanmış olup, token sayıları tiktoken kullanılarak cl100k_base üzerinden elde edilmiştir ve Ekim 2026 itibarıyla projenin docs/performance.md kısmında yayınlanmıştır. Kendi maliyetiniz, kullandığınız modele ve fiyatlara göre değişiklik gösterecektir.
Proje ayrıca, kitaptan tek bir soruya yanıt vermek için gereken token sayısının, kitabın tamamının bağlama (context) yapıştırılmasına kıyasla 24 ila 51 kat daha az olduğunu belgelemektedir. Bunu bir taahhüt olarak değil, tasarruf potansiyelinin bir göstergesi olarak değerlendirin; zira bu durum kitaba ve soruya bağlıdır. Yapısal gerçek her iki durumda da geçerlidir: dönüştürme işlemi bir kez ödenir, ancak bağlam dökümü (context dump) kitabı gerektiren her görüşmede tekrar ödenir.
Neden PDF'i yapıştırmıyoruz veya bir RAG dizini oluşturmuyoruz?
Metni yapıştırmak işe yarar ve tek bir belgeyle ilgili tek bir soru için doğru yöntemdir. Ancak aynı kitaba Salı günü ve tekrar Cuma günü ihtiyaç duyulduğunda bu yöntem verimsizleşir, çünkü her seferinde kitabın tüm boyutunun maliyetini ödersiniz.
Retrieval (geri getirme) veya RAG (retrieval augmented generation), sorgu anında arama yapar ve kelimelerinizle eşleşen pasajları geri döndürür. Tam cümleye ihtiyaç duyduğunuzda bu yöntem güçlüdür. Ancak faydalı bilgi bir bölümün tamamına yayılmış bir çerçeve olduğunda zayıf kalır, çünkü hiçbir pasaj bu bilgiyi tek başına içermez. Bir skill, bu çıkarımı dönüştürme aşamasında bir kez yapar ve pasajlar yerine yapıyı depolar.
Dürüst bir sınırlama: oluşturulan bir skill, bir model tarafından yazılmış kayıplı bir özet niteliğindedir. Bu bir çalışma yardımcısıdır ve kaynak her zaman asıl belgedir. Tam ifadelerin yasal veya protokole dayalı bir ağırlığı olduğunda, PDF'i saklayın ve alıntıyı oradan yapın. MCP sunucuları ve kural dosyalarına karşı skill karşılaştırmaları bölümü, her yaklaşımın nerede kullanılması gerektiğini açıklar.
Hata modları ve karşılaşacağınız dizgeler
Taranmış bir PDF hiçbir sonuç üretmiyor. pdftotext yüklü olduğunda, çıkarıcı ilk beş sayfayı bir metin katmanı için kontrol eder ve metin bulunamazsa bir açıklama ile durur. Bu araç olmadan, normal yedekleme zinciri çalışır ve başarısız olmadan önce tüm PDF'i işlemeye çalışabilir. Önce ocrmypdf input.pdf output.pdf komutunu çalıştırın, ardından çıktı dosyasını buna besleyin.
pip yüklemeyi reddediyor. Ubuntu 24.04 üzerindeki error: externally-managed-environment, apt'nin sistem Python'unu korumasından kaynaklanır. Yukarıdaki sanal ortamı kullanın veya poppler-utils yükleyerek pip'i tamamen devre dışı bırakın.
Bölümler yanlış çıkıyor. Bölüm algılama, Chapter 7 ve bunun dil varyantları gibi açık başlıkları arar; ayrıca Chapter IV veya IV. Title gibi Romen rakamlarını da tanır. Numaralandırılmamış, yalın bölüm başlıkları kullanan bir kitap hatalı bölünür; çözüm, aracın tahmin etmesini beklemek yerine bölümlerin nerede başladığını belirtmektir.
Komut bulunamadı. Otomatik tamamlama listesinde /book-to-skill eksikse, bu durum skills dizininin oturumunuz başladıktan sonra oluşturulduğu anlamına gelebilir. /reload-skills komutunu çalıştırın veya ajanı yeniden başlatın.
Docling çok uzun sürüyor. Sayfa başına yaklaşık 1,5 saniyelik işlem süresiyle, uzun bir kitap için CPU süresi dakikalarca sürebilir; paylaşımlı bir sunucuda bu işlem, barındırdığınız diğer her şeyle kaynak rekabetine girer. İçerik türü sorulduğunda "text-heavy" yanıtını verin veya scripts/extract.py aracını kendiniz çalıştırırken --mode text bayrağını kullanın. Docling'i seçen yanıt --mode technical değeridir.
Bir kaynak sessizce kayboluyor. Okunamayan bir dosya, toplu işlemin tamamlanabilmesi için atlanır. Çıkarıcı bir WARNING: Skipping mesajı yazdırır, ancak işlem yine de verdiğinizden daha az kaynakla başarı rapor edebilir; bu nedenle bitmiş çıktıyı kaynak dosyalarınızla karşılaştırın. Bitmiş bir işlemi verdiğiniz kaynaklarla karşılaştırma alışkanlığı bu aracın ötesinde de geçerlidir ve tembel olmayan yeteneğin Derinlik Ağacı yöntemi, bir ajanın işi erken bitti ilan etmek yerine kendisini aynı standarda tabi tutmasını sağlamanın bir yoludur.
Aynı modeli manuel olarak uygulama
Araç bir kolaylıktır. Taşınabilir olan kısım yapıdır; bir metin düzenleyici, sahip olduğunuz her türlü referans materyali için bu yapıyı oluşturabilir.
- Bir giriş dosyası yazın ve bunu dönüştürücünün hedeflediği 4,000 token'larının yakınında tutun. Adlandırılmış kavramları, tam formülasyonlarıyla birlikte bu dosyaya ekleyin; ayrıca her bir detay dosyasını ve o dosyanın içerdiği konu başlıklarını listeleyen bir dizin oluşturun.
- Materyali, her biri yaklaşık 1,000 token uzunluğunda olacak şekilde, konu başına bir dosya olacak biçimde bölün. Dosya isimlerini, içeriği tek başına ifade edecek şekilde belirleyin.
- Giriş dosyasından, bu dosyaların her birini ne zaman okumanız gerektiğini belirten bir cümle ile tanımlayın.
- adım, insanların atladığı ancak modelin çalışmasını sağlayan kısımdır. Ajan, dizini okuyarak neyi açacağına karar verir; bu nedenle dizinde tanımlanmayan bir dosya, ajanın asla açmayacağı bir dosyadır. Dizin üründür, bölüm dosyaları ise depolama alanıdır.
Sıkıştırma işleminden sonra yeniden eklendiğinde kesintiye uğramaması için giriş dosyasını 5.000 token'ın altında tutun; eğer toplam bütçe dosya boyutunu düşürürse, yeteneği tekrar çağırın. Bu kural, dosyaları bir dönüştürücü yazsa da siz yazsanız da geçerlidir.
FAQ
Satın aldığım bir kitaptan oluşturduğum yeteneği (skill) yayınlayabilir miyim?
Hayır, kitabın lisansı yeniden dağıtıma izin vermediği sürece yayınlayamazsınız. Dönüştürücü üzerindeki MIT lisansı yalnızca dönüştürücünün kodunu kapsar, içine beslediğiniz materyali değil; oluşturulan yetenek ise kitabın türev bir çalışmasıdır. Bunu kendi makinenizdeki ~/.claude/skills/ içinde tutun. Kendi yazdığınız belgeler veya açık lisanslı kaynaklar için yayınlama yapmakta bir sakınca yoktur. Sabitlenmiş v1.4.0 görünürlük hakkında hiçbir zaman soru sormaz; projenin varsayılan dalı ise artık bunu ayrı bir soru olarak sormakta ve yalnızca çıplak bir public üzerinde herkese açık hale gelmektedir; dolayısıyla her iki durumda da karar tamamen size aittir.
docling kullanmam gerekiyor mu, yoksa pdftotext yeterli mi?
Düz metinler için poppler-utils içindeki pdftotext yeterlidir ve neredeyse anında sonuç verir. Kitabın değeri tablolarında ve kod listelerinde saklıysa docling kurun, çünkü düz metin çıkarıcılar bu yapıları düzleştirir. Buradaki ödünleşim hızdır: proje, docling'in sayfa başına yaklaşık 1,5 saniyede çalıştığını ölçmüştür; bu da 300 sayfalık bir kılavuzun bir VPS üzerinde birkaç dakikalık CPU süresi harcaması demektir.
VPS üzerinde pip neden externally-managed-environment hatası veriyor?
Ubuntu 24.04 ve güncel Debian sürümleri, sistem Python'ını apt tarafından yönetilen bir paket olarak işaretler; bu nedenle pip, sistem dizinine kurulum yapmayı reddeder ve error: externally-managed-environment çıktısını verir. python3 -m venv ~/.venvs/book-to-skill ile bir sanal ortam oluşturun, etkinleştirin, çıkarıcıları buraya kurun ve ardından ajansınızı aynı kabuk üzerinden başlatın. Yetenek python3 komutunu çağırır, bu nedenle PATH üzerinde hangi yorumlayıcı varsa onu kullanır; bu da artık sanal ortamdaki yorumlayıcıdır.
Oluşturduğum yetenek neden eğik çizgi (slash) komutu olarak görünmüyor?
İki sebebi vardır. Dizin adı yeteneği çağırır ve frontmatter içindeki name de komutunu belirler; bu nedenle yetenek, SKILL.md tam olarak o şekilde yazılmış halde ~/.claude/skills/<name>/SKILL.md veya .claude/skills/<name>/SKILL.md dizininde bulunmalıdır. Yol doğruysa /reload-skills komutunu çalıştırın veya ajanı yeniden başlatın. Claude Code, halihazırda izlediği yetenek dizinlerindeki düzenlemeleri algılar, ancak oturum başladıktan sonra oluşturulan bir yetenek dizini siz işlem yapana kadar izlenmez.