Claude Cowork Eklentileri: Kurulum, Özelleştirme ve Kendi Eklentinizi Geliştirme

Claude Cowork Eklentileri Nedir?

Bir Claude Cowork eklentisi, Claude’un bir uzman gibi çalışması için gereken her şeyi paketleyen kurulabilir bir pakettir. İş akışı becerileri, eğik çizgi komutları, uygun bağlayıcılar ve gerekli alt aracılar ile kancalar gibi öğeleri içerir. Anthropic’in lansman gönderisi bunu tek cümlede şöyle özetliyor: 

"Eklentiler; herhangi bir beceriyi, bağlayıcıyı, eğik çizgi komutunu ve alt ajanı bir araya getirerek Claude’u rolünüz, ekibiniz ve şirketiniz için bir uzmana dönüştürmenizi sağlar."

Eklentiler, 30 Ocak 2026’da Cowork’a, Anthropic’in ekiplerinin geliştirdiği 11 açık kaynaklı eklentiyle birlikte, ücretli kullanıcılar için araştırma ön izlemesi olarak geldi. İkinci dalga 24 Şubat 2026’da İK, tasarım, mühendislik, operasyon ve finansal analiz eklentilerini; 4 finansal hizmetler eklentisini; Slack, S&P Global ve LSEG iş ortaklarından eklentileri ve eğik çizgi komutları için yapılandırılmış formları ekledi. Cowork’un kendisi ön izlemeyi bırakarak 9 Nisan 2026’da genel kullanıma açıldı.

Eklentilerin nerede çalıştığı kafa karıştırabiliyor; işte Anthropic’in yardım merkezi makalesindeki güncel yanıt. Eklediğiniz bir eklenti bilgisayarınıza değil, Claude hesabınıza kaydedilir; bu yüzden web sohbetine, masaüstü uygulamasına, Cowork’a ve Claude Code’a (2.1.273 veya sonrası otomatik senkronlar) sizinle birlikte gelir. Beceriler ve komutlar bunların hepsinde çalışır; kancalar ve alt aracılar ise yalnızca Cowork ve Claude Code’da çalışır ve sohbette gri görünür.

Cowork’u henüz kullanmadıysanız, Claude Cowork eğitimi uygulamayı adım adım anlatır ve Claude Cowork ile Claude Code karşılaştırması aynı eklentinin birinde neden daha fazlasını yapabildiğini açıklar. Cowork’u burada yeniden anlatmayacağım.

Bir eklentinin paketledikleri

Aşağıdaki tablo, bir eklentinin tutabileceği 5 bileşeni, her birinin ne yaptığını ve ne zaman tetiklendiğini listeler.

Beceriler Claude onları ilgili bulduğunda tetiklenir; komutlar siz / yazdığınızda tetiklenir. Bu ayrım, bir eklenti hiçbir şey yapmıyor gibi göründüğünde neyi kontrol edeceğinizi belirler; doğrulama bölümünde buna döneceğim. Alt aracılar size yeni geldiyse, Yapay Zekâ Ajanlarına Giriş kursumuz, herhangi bir kod olmadan delege etme desenini kapsar.

Eklenti ve beceri

Bir beceri, tek bir SKILL.md dosyasında Claude’a tek bir görevi öğretir. Bir eklenti ise bir iş fonksiyonu için beceri, komut ve bağlayıcıların paketlenmiş setidir; bu nedenle Data eklentisi 10 beceri içerir ve kurduğunuz birim eklentidir; düzenlediğiniz birim ise beceridir. Claude Becerileri rehberimiz, isterseniz beceri biçimini derinlemesine inceler.

Cowork Eklentileri Nerede Bulunur?

Cowork eklentileri 3 kaynaktan gelir ve bu makalenin çoğunda ilkini kullanacaksınız:

• Cowork içine yerleşik pazar yerleri. Knowledge Work marketplace varsayılan olarak her hesaba eklenir. Anthropic’in Life Sciences, Financial Services ve Legal pazar yerleri Sırayla Ekle, Marketplace ekle, ardından Anthropic kaynaklarına göz at altındadır.
• claude.com/plugins dizini. 300’den fazla eklentiyi listeler ve her birinin Claude, Claude Code veya her ikisiyle çalışıp çalışmadığına dair bir filtre sunar.
• GitHub’daki anthropics/knowledge-work-plugins deposu. Bu, Anthropic tarafından geliştirilen tüm rol eklentilerinin Apache-2.0 kaynağıdır ve aşağıda alıntılanan dosyaları burada okudum.

İki başka kurulum yolu daha var: herhangi bir Git deposunu URL’siyle veya owner/repo kısaltmasıyla bir pazar yeri olarak eklemek (GitHub, GitHub Enterprise ve herkese açık GitLab ve Bitbucket depoları çalışır) ya da bir eklenti dosyasını doğrudan en fazla 200 MB’lık bir .zip veya .plugin arşivi olarak yüklemek. 

Rol yelpazesi birçok farklı alanda her şeyi kapsar: üretkenlik, satış, müşteri desteği, ürün yönetimi, pazarlama, hukuk, finans, veri, kurumsal arama, İK, tasarım, mühendislik, operasyon, biyo-araştırma ve küçük işletme, ayrıca iş ortağı yapımı eklentiler. Bu makale bir derleme değil; işinize uygun olanı seçin ve okumaya devam edin.

Bir Cowork Eklentisinin İçinde Ne Var?

Bir Cowork eklentisi, gizli bir alt klasörde bir manifestonun ve geri kalan her şeyin üst düzeyde olduğu bir klasördür. İşte tam yerleşim; bileşenlerle birlikte, yalnızca bazı yüzeyler yüklendiğinde işaretlenmiştir:

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # manifest (required)
├── skills/
│   └── <name>/SKILL.md      # skills: auto-triggered knowledge & named actions
├── commands/
│   └── <name>.md            # legacy single-file slash commands (still work)
├── agents/
│   └── <name>.md            # sub-agents (Cowork and Claude Code only)
├── hooks/
│   └── hooks.json           # hooks (Cowork and Claude Code only)
├── .mcp.json                # connectors
└── README.md

Bu ağacı aklınızda tutun; çünkü Adım 4 bunun üst yarısını dosya dosya inşa ediyor. Aşağıdaki görsel, ağacı Anthropic’in platform desteği tablosundan her bileşenin nerede çalıştığıyla eşleştirir.

Şekil 1. Solda bir eklentinin klasörü ve her bileşen için ne zaman tetiklendiği ile sohbet, Cowork veya Claude Code’un yükleyip yüklemediği. Görsel: yazar.

Manifesto

Manifesto .claude-plugin/plugin.json dosyasıdır ve yalnızca name alanı zorunludur. Bu, depodan kopyalanmış Anthropic’in Data eklentisinin gerçek manifestosudur:

{
  "name": "data",
  "version": "1.1.0",
  "description": "Write SQL, explore datasets, and generate insights faster. Build visualizations and dashboards, and turn raw data into clear stories for stakeholders.",
  "author": {
    "name": "Anthropic"
  }
}

Bilmeniz gereken üç şey:

• name, eklentinin kalıcı kimliğidir ve her bileşene önek olur; bu nedenle write-query becerisi /data:write-query olur.

• version dizgesi, insanların eklenti için gördüğü sürüm numarasıdır ve Anthropic’in geliştirme rehberi her sürümde artırılmasını söyler.

• İsteğe bağlı alanlar arasında displayName, license, homepage ve keywords bulunur.

Beceriler ve komutlar

Bir beceri, skills/<name>/SKILL.md konumunda yaşar: üstte --- çizgileri arasında kısa bir ayar bloğu (YAML ön bilgi), altında Claude’a talimatlar. İşte Data eklentisinin write-query becerisinin üst kısmı; Adım 2’de çalıştırdığım beceri:

---
name: write-query
description: Write optimized SQL for your dialect with best practices. Use when translating a natural-language data need into SQL, building a multi-CTE query with joins and aggregations, optimizing a query against a large partitioned table, or getting dialect-specific syntax for Snowflake, BigQuery, Postgres, etc.
argument-hint: "<description of what data you need>"
---

# /write-query - Write Optimized SQL

description, Claude’un beceriyi yükleyip yüklememeye karar vermek için okuduğu kısımdır ve argument-hint becerinin sizden ne yazmanızı beklediğini söyler. İki ön bilgi bayrağı, bir becerinin nasıl tetikleneceğini değiştirir: 

• user-invocable: false, onu / menüsünden gizler; böylece yalnızca Claude yükleyebilir (eklentinin sql-queries becerisi bu şekilde ayarlı)

• disable-model-invocation: true ise tersini yapar; beceri sadece adını yazdığınızda çalışır.

Komutlar daha eski biçimdir: commands/<name>.md konumunda ön bilgisinde bir description bulunan tek bir Markdown dosyası. Anthropic’in kendi eklenti-yazım becerisi artık Claude’a "yeni eklentileri skills/*/SKILL.md ile iskeletini oluştur" der ve commands/ klasörünü eski (legacy) olarak adlandırır; çünkü Cowork arayüzü ikisini tek bir Beceriler listesi olarak gösterir. Komutlar hâlâ her yerde yüklenir; bu yüzden eski eklentilerde onlarla karşılaşmaya devam edeceksiniz, ancak Adım 4 becerileri kullanır.

Bağlayıcılar

Eklenti kökündeki .mcp.json dosyası, eklentinin erişebileceği harici hizmetleri MCP sunucu URL’si olarak listeler. İşte Data eklentisinin dosyasındaki ilk 3 kayıt:

{
  "mcpServers": {
    "snowflake": {
      "type": "http",
      "url": ""
    },
    "databricks": {
      "type": "http",
      "url": ""
    },
    "bigquery": {
      "type": "http",
      "url": "https://bigquery.googleapis.com/mcp"
    },

Boş URL’ler yer tutucudur: Anthropic BigQuery uç noktasını gönderir, ancak Snowflake ve Databricks’i kendi sunucu adresinizle doldurmanızı bekler. MCP’nin kendisi yeni geliyorsa, Model Context Protocol rehberimiz sıfırdan bir sunucu kurar.

Görünmeyen bir kısıt var: Anthropic’in yardım merkezi, "Cowork’ta bağlayıcılar harici hizmetlere yerel ağınız üzerinden değil, Anthropic’in bulutu üzerinden erişir" der. Bu nedenle özel bir bağlayıcı, "Anthropic’in IP aralıklarından genel internet üzerinden erişilebilir" bir sunucuyu işaret etmelidir. Güvenlik duvarı veya VPN arkasındaki bir ambar, ağ ekibiniz Anthropic adreslerini allowlist’e ekleyene kadar bağlanmaz.

Yerel MCP sunucuları, yani makinenizde bir program başlatan türler, istisnadır: Claude Code’da ve bilgisayarınızda çalışan Cowork oturumlarında çalışırlar; sohbet onları yok sayar. 

6 Ekim 2026’dan beri, yeni Pro ve Max görevleri yalnızca Anthropic’in bulutunda çalışır; bu nedenle yerel oturumlar ağırlıkla Team ve Enterprise özelliğidir.

Adım 1: İlk Eklentinizi Kurmak

Bir Cowork eklentisi kurmak, Özelleştir sayfasında 6 kısa adımdan oluşur ve katalogdaki her eklenti için adımlar aynıdır; dolayısıyla satış veya hukuk alanındaki okuyucular kendi eklentilerini seçebilir. SQL örneğini Adım 2’de kurduğu için Data eklentisini kullanıyorum.

1. Claude masaüstü uygulamasının sol kenar çubuğundan Customize’ı açın. Uygulamanız hâlâ bir Cowork sekmesi gösteriyorsa önce onu açın.

2. Plugins sekmesini açın.

3. Knowledge Work marketplace’in sizde olduğundan emin olalım. + Add’a, ardından Add marketplace’e, sonra Browse Anthropic sources’a tıklayın.

4. Knowledge Work eklentilerini seçip ekleyin.

5. Discover sekmesini açın. Knowledge Work marketplace zaten orada olmalı. Code filtresine tıklayın.

6. Data’yı seçin, ardından Add’a tıklayın. Bazı sürümlerde düğme Install olarak etiketlidir.

Ardından eklenti sayfası neleri aldığınızı listeler: Skills sekmesi 10 beceri gösterir; bunların 7’sini adla çalıştırabilirsiniz (analyze, explore-data, write-query, create-viz, build-dashboard, validate-data ve data-context-extractor) ve 3’ü arka planda yüklenir (sql-queries, data-visualization ve statistical-analysis). Depodaki bağlayıcı dosyası Snowflake, Databricks, BigQuery, Definite, Hex, Amplitude (ayrı bir AB girişiyle) ve Atlassian’ı listeler ve siz oturum açana kadar hiçbiri bağlı değildir. Data eklentisi dizin sayfası 28 Eylül 2026’da 7.655 kurulumu gösteriyordu.

Terminalde rahatsanız aynı eklenti, depodaki README’den 2 komutla Claude Code’a kurulur:

claude plugin marketplace add anthropics/knowledge-work-plugins
claude plugin install data@knowledge-work-plugins

Önemli bir fark var: Özelleştir’den eklediğiniz bir eklenti Claude Code’a senkronlanır; ancak komut satırından kurduğunuz bir eklenti o makinede kalır ve hesabınıza asla gelmez. Claude Code eklentileri geliştirme rehberimiz terminal iş akışını ayrıntılı şekilde kapsar; bu nedenle burada masaüstü yolunda kalıyorum.

Team ve Enterprise planlarında, bir sahip her eklentiyi 4 durumdan birine ayarlar: kullanılamaz, kurulmaya hazır, varsayılan olarak kurulu veya zorunlu. Enterprise yöneticileri bunları gruplara göre geçersiz kılabilir; bu yüzden yardım merkezi, "katalogda gördüğünüz eklentiler diğer gruplardaki meslektaşlarınızın gördüklerinden farklı olabilir" diye uyarır. Discover sekmenizde Data yoksa, pazar yerinin bozuk olduğunu varsaymadan önce bir sahipten rica edin.

Adım 2: Bir Veri Kaynağı Bağlamak ve Bir Eğik Çizgi Komutu Çalıştırmak

Bağlı olmayan bir ambarla eklenti, yalnızca başka bir yere yapıştırmanız için SQL yazabilir; bu nedenle ilk gerçek adım bir veri kaynağı bağlamaktır. Sonrasında eğik çizgi komutu gerisini halleder.

Bir bağlayıcıyı yetkilendirmek

Bir eklentiyi eklemek, herhangi bir şeye giriş yapmanız anlamına gelmez. Eklentinin Connectors sekmesini açın; burada her kayıt 3 durumdan birini gösterir: Connected, Not connected (bağlayıcı hesabınızda ama siz giriş yapmadınız) veya Not added. Gerekliyse Add’a, sonra Connect’e tıklayın ve tarayıcınızda hizmete giriş yapmayı tamamlayın.

Team ve Enterprise planlarında önce bir sahip, bağlayıcıyı kuruluş için ekler; ardından siz kendi hesabınızla bağlanırsınız.

Ambar için salt-okunur kimlik bilgilerini kullanın; çünkü yazma yetkili bir bağlayıcı, araçlarının sunduğu herhangi bir ifadeyi Claude’un çalıştırmasına izin verir ve Cowork’un otomatik modunda Claude bunları çağırıp çağırmayacağına kendisi karar verir. Bu şu anlama gelir:

• Snowflake için yalnızca SELECT yetkisine sahip bir rol

• BigQuery için Data Viewer rolüne sahip bir hizmet hesabı

• Databricks için salt-okunur bir SQL ambarına kapsamlanmış bir belirteç

Platforma yeniyseniz, Snowflake’e yeni başlayanlar kılavuzumuz ve BigQuery eğitimi her birinde bir öğleden sonra içinde ilk sorgunuza ulaştırır.

Bağlantı, Özelleştir ardından Connectors altında hesabınızda bulunur; böylece her hizmeti bir kez yetkilendirirsiniz ve Data eklentisindeki BigQuery girdisi gibi aynı sunucu URL’sini listeleyen başka herhangi bir eklenti bunu yeniden kullanır.

İlk komutunuzu çalıştırmak

write-query komutu, sade bir dildeki soruyu sizin lehçenizde SQL’e çevirir ve doğrulama bölümünde tekrar döneceğim için özellikle bakmanızı istediğim çıktıdır. 

4 tablonun bulunduğu ve 5 Ocak–27 Eylül 2026 arası 1.600 sipariş içeren küçük bir SQLite veritabanı, shop.db, oluşturdum; bir e-ticaret ambarında bulunacak türden. Aşağıdaki tablo şemayı tanımlar; bu makaledeki her sorgu buna karşı çalışır.

Komutu çalıştırmak için mesaj kutusunda / yazın ve Data eklentisinden write-query’i seçin ya da /data:write-query yazın. 

24 Şubat 2026 güncellemesinden beri bir komut yazmak, ipucu metnini mesaj kutusuna koyar ve Claude başlamadan önce numaralı seçeneklerle yapılandırılmış bir soru sorabilir; aşağıda Anthropic’in ekran görüntüsü /dashboard komutuyla bunu gösteriyor. 

Cowork’ta bir eğik çizgi komutunu başlatan yapılandırılmış form; Anthropic tarafından /dashboard komutuyla gösteriliyor: komutun ipucu mesaj kutusunda yer alıyor ve Claude başlamadan önce numaralı seçeneklerle soru soruyor. Görsel kaynağı: Anthropic, 24 Şubat 2026.

İsteğim şuydu: son 8 haftanın her biri için, yalnızca tamamlanmış siparişleri sayarak ve ürün satırı indirimlerini düşerek, ürün kategorisine göre net gelir; SQLite’ta; ve altına yapıştırılmış şemayla birlikte.

İşte düzenlenmemiş olarak dönen SQL:

-- Net revenue by product category, last 8 complete weeks (Mon–Sun), completed orders only
-- Dialect: SQLite
WITH RECURSIVE
params AS (
    SELECT
        -- Monday of the current week; 'weekday 0' jumps forward to Sunday, -6 days lands on Monday
        date('2026-09-28', 'weekday 0', '-6 days')              AS current_week_start,  -- 2026-09-28
        date('2026-09-28', 'weekday 0', '-6 days', '-56 days')  AS range_start          -- 2026-08-03
),

-- One row per week, so weeks with no sales still show up
weeks AS (
    SELECT range_start AS week_start
    FROM params
    UNION ALL
    SELECT date(w.week_start, '+7 days')
    FROM weeks AS w
    CROSS JOIN params AS pr
    WHERE date(w.week_start, '+7 days') < pr.current_week_start
),

categories AS (
    SELECT DISTINCT category
    FROM products
),

-- Filter and aggregate at the line-item level before building the grid
weekly_category_revenue AS (
    SELECT
        date(o.order_date, 'weekday 0', '-6 days')                          AS week_start,
        p.category,
        -- discount_pct is stored as 0–25 (a percent), not as a 0–0.25 fraction
        SUM(oi.quantity * oi.unit_price * (1 - oi.discount_pct / 100.0))    AS net_revenue
    FROM orders AS o
    CROSS JOIN params AS pr
    INNER JOIN order_items AS oi ON oi.order_id = o.order_id
    INNER JOIN products    AS p  ON p.product_id = oi.product_id
    WHERE o.status = 'completed'
      -- Plain string comparison, so an index on order_date can be used; works for ISO-8601 dates
      AND o.order_date >= pr.range_start
      AND o.order_date <  pr.current_week_start
    GROUP BY 1, 2
)

SELECT
    w.week_start,
    date(w.week_start, '+6 days')             AS week_end,
    c.category,
    ROUND(COALESCE(r.net_revenue, 0), 2)      AS net_revenue
FROM weeks AS w
CROSS JOIN categories AS c
LEFT JOIN weekly_category_revenue AS r
       ON r.week_start = w.week_start
      AND r.category   = c.category
ORDER BY w.week_start, net_revenue DESC, c.category;

Bu, el ile yazacağım olandan daha uzun ve değer de fazladan uzunlukta gizli. Sorgunun her bloğu, ortak tablo ifadesi (CTE) diye adlandırılır ve tek bir iş yapar:

• params, her şeyi tek bir tarihe sabitler; böylece sorguyu yeniden işaret etmek kolaydır.

• weeks özyinelemelidir ve satışı olmayan bir hafta için de bir satır garanti eder.

• weekly_category_revenue yalnızca status = 'completed' olanları tutar ve şema, sütunun 0–25 arasında tam yüzde tuttuğunu söylediği için indirimi 1 - discount_pct / 100.0 olarak uygular.

• Son SELECT boşlukları 0 ile doldurur; böylece çıktı çizelgelemeye hazırdır.

Beceri ayrıca sorgunun altında varsayımlarını listeler; örneğin aralık filtresinin çalışması için order_date’in ISO 8601 metin (YYYY-MM-DD) olması ve iade edilen siparişlerin tamamen düşülmesi gibi.

Sorguyu shop.db üzerinde çalıştırdım ve her hafta ve kategori için bir satır olmak üzere 40 satır elde ettim. İşte kategoriler sütun olacak şekilde pivotlanmış hâli:

Audio, 8 haftanın 5’inde en büyük kategori ve asla 8.780’in altına düşmüyor. Home Office en çok dalgalanan; 10 Ağustos haftasında 5.380’den 31 Ağustos haftasında 14.252’ye çıktı. Fitness dönem sonunda dip seviyesi olan 4.149’da; bu da haftalık bir raporun vurgulaması gereken türden bir hareket ve Adım 4’te oluşturduğum eklenti de tam olarak bunu vurguluyor.

Aşağıdaki grafik, aynı 40 sayıyı, kategori başına bir panel olarak gösterir.

Şekil 2. 27 Eylül 2026’da biten 8 tam hafta boyunca ürün kategorisine göre tamamlanmış siparişlerin haftalık net geliri; write-query sonucundan. Görsel: yazar.

Adım 3: Kurulu Bir Eklentiyi Özelleştirmek

Kurulum 2 dakika sürer. Özelleştirme, bir eklentinin yerini hak etmeye başladığı yerdir; çünkü Anthropic’in eklentileri genel bir şirket için yazılmıştır, sizinki öyle değil. Bunu yapmanın 2 yolu var.

Edit with Claude’u kullanmak

Edit with Claude’a tıklamak, Claude’un eklentiyi sizinle birlikte düzenlediği bir Cowork görevi açar.

Yardım merkezi düğmeyi hâlâ Customize olarak adlandırıyor. Güncel uygulamada, eklentinin sağ üst köşesindeki menüsünü açın ve Edit with Claude’u seçin; bu, "seçtiğiniz eklentiyi özelleştirmesi için Claude’a bir istemle yeni bir Cowork görevi açar"; ardından Let’s go’ya tıklayın. Arka planda bu, Anthropic’in Plugin Management eklentisindeki cowork-plugin-customizer becerisini çalıştırır.

Beceri önce eklentinin dosyalarında ~~ yer tutucularını, örneğin ~~data warehouse, arar; sonra bağlı Slack veya belge araçlarında gerçek adları arar ve bulamadığı her şey için sizden ister. 

Burada yapılacak somut bir düzenleme tablo adlandırmanızdır: kanonik tabloların analytics şemasında yaşadığını, sorgulanacak tek sipariş tablosunun fct_orders olduğunu ve stg_ öneki taşıyan her şeyin yasak olduğunu söyleyin. Claude bu kuralları SQL becerisine yazar ve konuşmada özelleştirilmiş eklentiyi gösterir; o sonuçtaki düğmeyle kabul edersiniz.

Dosyaları doğrudan düzenlemek

İkinci yol, eklentinin dosyalarını açıp kendiniz düzenlemektir; zaten nasıl yazacağınızı bildiğiniz değişiklikler için uygundur. En çok karşılığını veren üç düzenleme:

• Bir beceriye şirket bağlamı ekleyin. Ölçüt tanımlarınızı, kanonik tablolarınızı ve asla sorgulanmaması gereken tabloları skills/sql-queries/SKILL.md dosyasının sonuna ekleyin. Kullandığım blok, Adım 4’te kendi başına bir beceri haline gelir ve 4 satırı şöyle görünür:

- orders: one row per order. status is completed, refunded, or canceled. order_date is ISO 8601 (YYYY-MM-DD).
- order_items: one row per product line. unit_price is the price charged before discount. discount_pct is a whole-number percentage from 0 to 25.
- products: one row per product, with its category.
- Never compute revenue from products.list_price. It is the catalog price, not what the customer paid.

• .mcp.json içinde bağlayıcıları değiştirin. Kullanmadığınız hizmetlerin girişlerini silin ve boş Snowflake veya Databricks URL’sini kendi sunucu adresinizle doldurun ya da ambarınızı Özelleştir sonra Connectors altında özel bağlayıcı olarak ekleyin.

• Sürümü artırın. Her düzenlemede plugin.json’daki sürümü değiştirin; böylece kopyanızı orijinalinden ayırt edebilirsiniz.

Not edilecek bir şey: Anthropic’in Cowork eklenti rehberi, Cowork’un pazar yerindeki güncellemeleri kontrol ettiğini ve "yerel olarak bir eklentinin dosyalarını düzenlediyseniz, Cowork bu değişikliği algılar ve bir güncellemenin onları üzerine yazmadan önce sizi uyarır" der. Kuruluş tarafından yönetilen eklentiler ve bir meslektaşınızın sizinle paylaştığı eklentiler hiç düzenlenemez; bu yüzden önce kendi eklentinize kopyalayın.

Windows kullanıcıları için başka bir uyarı: 11 Eylül 2026’da açılan bir hata raporu, ilk kurulu sürümde donup kalan, yeni yüklemeler, kaldırmalar ve yeniden yüklemeler sonrası yeniden başlatmada geri dönen, kullanıcı tarafından yüklenmiş bir eklentiyi anlatıyor. 6 Ekim 2026’da hâlâ açık ve çözümsüzdü; bu yüzden düzenlemeleriniz Windows’ta kalıcı olmamaya başlarsa, döngü halinde yeniden yüklemek yerine o başlığı kontrol edin.

Adım 4: Sıfırdan Özel Bir Eklenti Geliştirmek

Hiçbir pazar yeri eklentisi iş akışınızı bilmiyorsa, çözüm özel bir eklentidir. Örnek bir geliştirmeyi birlikte yapalım: 1 bilgi becerisi, 1 komut ve 1 bağlayıcı ile haftalık ölçüt raporu.

Her dosya tam hâliyle görünür; çünkü ürün klasörün kendisidir. Aşağıdaki görsel takip edeceğiniz döngüyü gösterir.

Şekil 3. Özel bir eklenti geliştirmek: dosyaları bilgisayarınızda yazın ve doğrulayın, zipleyip yükleyin, sonra yeni bir görevde komutu çalıştırın ve değişiklikler için dosyalara geri dönün. Görsel: yazar.

Plugin Create ile iskelet çıkarma

Plugin Create, yönlendirmeli güzergâh için Anthropic’in verdiği isimdir ve Eylül 2026’da Add menüsünde yer alır. Customize, Plugins, Add, ardından Create with Claude’a gidin; bu, isteği önceden doldurulmuş bir Cowork görevi açar.

İşi bir meslektaşınıza anlatır gibi tarif edin, hangi bağlayıcıların ekleneceğine dair Claude’un sorularını yanıtlayın ve ürettiği dosya kartında Save plugin’e tıklayın. Aynı menü, ne yazması gerektiğini zaten bilenler için Create a plugin, bir form ve bir düzenleyici de sunar.

Bu makaledeki eklenti için yazacağım kısa brifing aşağıdadır. Tek komutu, tek arka plan becerisini, tek bağlayıcıyı ve kuralları adlandırır; bu da, becerinin keşif sorularının aksi hâlde sizden tek tek çıkaracağı bilgilerdir.

Build me a plugin called Weekly Metrics Report for our online store's data team.

What it does: every Monday, compare the most recent complete week (Monday to Sunday) with the week before it and write a short Markdown report. Keep it to one command, /weekly-report, that runs the whole thing, and one background skill that holds our metric definitions so Claude never guesses them.

The definitions: net revenue is quantity times unit price after the line discount, for completed orders only. Completed orders are counted by distinct order ID. Average order value is net revenue divided by completed orders. Refund rate is refunded orders divided by completed plus refunded orders, as a percentage with one decimal. Cancelled orders never count toward anything.

The data: the canonical tables are orders, order_items, and products in our BigQuery warehouse. Never use products.list_price for revenue; it is the catalog price, not what the customer paid. Bundle the BigQuery connector and nothing else.

The report: a three-sentence summary that names the biggest mover and says whether it went up or down, a table of net revenue by product category (this week, last week, percentage change with one decimal and a sign), a second table with the overall metrics for both weeks, and the SQL at the end so a reader can check it. If either week has fewer than 20 completed orders, say the comparison is noisy.

Do not add agents, hooks, or any other skills.

Yönlendirmeli güzergâh, Knowledge Work marketplace’teki Plugin Management eklentisinin create-cowork-plugin becerisini çalıştırır. Bu eklentiyi kurup beceriyi adla çalıştırabilirsiniz. İş, bileşenler ve bağlayıcılar hakkında sorar, sonra sonucu bir .plugin dosyasına paketler.

Sonunda elde edeceğiniz klasör şöyledir:

weekly-metrics-report/
├── .claude-plugin/
│   └── plugin.json
├── .mcp.json
├── README.md
└── skills/
    ├── metric-definitions/
    │   └── SKILL.md
    └── weekly-report/
        └── SKILL.md

Manifesto, eklentiyi adlandırır ve sürümü sabitler:

{
  "name": "weekly-metrics-report",
  "displayName": "Weekly Metrics Report",
  "version": "0.1.0",
  "description": "Builds the store's weekly metrics report from the warehouse, using the team's own metric definitions.",
  "author": { "name": "Tim Lu" },
  "license": "MIT"
}

Bağlayıcı dosyası, Data eklentisinin kullandığıyla aynı BigQuery uç noktasını listeler; böylece Adım 2’de BigQuery’yi bağlayan bir okuyucunun yeniden yetkilendirmesi gerekmez:

{
  "mcpServers": {
    "bigquery": {
      "type": "http",
      "url": "https://bigquery.googleapis.com/mcp"
    }
  }
}

README özel bir eklenti için isteğe bağlıdır; dizine gönderecek olursanız gereklidir; bu yüzden şimdi yazdım:

# Weekly Metrics Report
A small Cowork plugin that turns "how did last week go?" into a consistent report. It holds the store's metric definitions in one skill and the report workflow in another, and it bundles the BigQuery connector so Claude can query the warehouse directly.

## Use it
Run /weekly-metrics-report:weekly-report, or ask for the weekly numbers in plain words. Claude compares the most recent complete week with the week before, writes a Markdown report with per-category and overall tables, and includes the SQL it ran.

## Data
The plugin reads the orders, order_items, and products tables through the connector you sign in to. It stores nothing itself.

Beceri yazmak

Bilgi becerisi, her Pazartesi yapıştırılan bağlamı tutar. İşte skills/metric-definitions/SKILL.md’nin tamamı:

---
name: metric-definitions
description: The store's definitions of net revenue, completed orders, average order value, and refund rate, plus which warehouse tables are canonical. Use whenever a request involves revenue, sales, orders, refunds, discounts, or which table to query, even if it does not name a metric.
user-invocable: false
---

# Metric definitions for the store warehouse
Follow these definitions whenever you compute or report a store metric. If a request conflicts with them, follow the definitions and say so.

## Canonical tables
- orders: one row per order. status is completed, refunded, or cancelled. order_date is ISO 8601 (YYYY-MM-DD).
- order_items: one row per product line. unit_price is the price charged before discount. discount_pct is a whole-number percentage from 0 to 25.
- products: one row per product, with its category.
- Never compute revenue from products.list_price. It is the catalog price, not what the customer paid.

## Metrics
- Net revenue: SUM(quantity * unit_price * (1 - discount_pct / 100.0)) over order_items, for orders with status = 'completed'.
- Completed orders: COUNT(DISTINCT order_id) where status = 'completed'.
- Average order value: net revenue divided by completed orders.
- Refund rate: refunded orders divided by completed plus refunded orders, as a percentage with one decimal.
- Cancelled orders never count toward revenue, order counts, or the refund rate.

## Weeks
- A week runs Monday to Sunday. Label a week by its Monday.
- "Last week" means the most recent complete week, not the last 7 days.

Açıklama, bu becerinin güvenilir şekilde tetiklenmesini sağlayan şeydir ve belirsiz bir açıklama, bir becerinin hiç tetiklenmemesinin yaygın nedenidir. Claude, bir beceriyi yüklemeye karar verene kadar yalnızca ön bilgiyi okur ve Claude Code becerileri referansı ana kullanım durumunu başa koymayı söyler. 

Açıklamayı, okuyucunun içinde bulunacağı durumlar olarak yazın ("bir istek gelir, satışlar, siparişler, iadeler, indirimler içerir") ve insanların kullandığı kelimeleri ekleyin; çünkü Claude, açıklamanızı onların mesajına karşı eşleştirir.

İki tercih daha bilinçlidir: user-invocable: false, kimsenin bir tanımlar setini "çalıştırmaması" gerektiğinden bu beceriyi / menüsünden uzak tutar. Gövde, Anthropic’in kendi yazım becerisinin istediği üslupta, emredici kipte Claude’a talimatlar olarak yazılmıştır (products.list_price’tan asla gelir hesaplama"). Tablolar bölümü, kendi ambarınızın adlarıyla değiştireceğiniz kısımdır.

Komutu yazmak

Komut da bir beceri dosyasıdır; çünkü yeni eklentiler adlandırılmış eylemleri bu şekilde tanımlar. İşte skills/weekly-report/SKILL.md’nin tamamı:

---
name: weekly-report
description: Build the store's weekly metrics report. Use when the user asks for the weekly report, the weekly numbers, week-over-week metrics, or how last week went.
argument-hint: "[a date inside the week to report on]"
---

# Weekly metrics report

Produce a short report comparing the most recent complete week with the week before it, using the definitions in the metric-definitions skill.

## Steps

1. Work out the reporting week. If the user gave a date, use the Monday-to-Sunday week that contains it. Otherwise use the most recent complete week before today.
2. Get the data. If a warehouse connector is connected, query it directly. If not, ask the user for a database file or an export and query that instead. Never estimate a number.
3. For the reporting week and the week before it, compute net revenue, completed orders, average order value, and refund rate, overall and per product category.
4. Write the report to a Markdown file named weekly_report_<week start>.md containing:
   - A three-sentence summary that names the biggest mover and says whether it went up or down.
   - A table with one row per category: net revenue this week, last week, and the percentage change.
   - A second table with the overall metrics for both weeks.
   - The SQL you ran, in a code block at the end, so the reader can check it.
5. Show the summary in the conversation and say where the file is.

## Rules

- Follow the metric-definitions skill for every metric. Do not invent new ones.
- Report percentage changes with one decimal place and a sign.
- If either week has fewer than 20 completed orders, say the comparison is noisy.

Bu beceri varsayılan olarak kullanıcı tarafından çağrılabilirdir; bu yüzden / menüsünde /weekly-metrics-report:weekly-report olarak görünür ve argument-hint aldığı tek argümanı belgelendirir. 

Gövde, metric-definitions becerisini iki kez adlandırır; açılış satırında ve kuralların içinde; komutun beceriyi çağırma şekli budur: Claude, adlandırıldığı ve açıklaması gelirle ilgili bir isteğe uyduğu için tanımları yükler. 

Eski biçimi tercih ederseniz, aynı gövde yalnızca ön bilgisinde description satırı olan commands/weekly-report.md olarak da çalışır.

Kurmak ve test etmek

Yüklemeden önce, claude plugin validate ./weekly-metrics-report komutuyla klasörü üst dizinine göre doğrulayın; bunun için Claude Code kurulu olmalıdır. Makinemde ✔ Validation passed yazdırdı ve başarısız olduğunda düzeltilecek alanı belirtir.

Sonra eklenti klasörünü zipleyin. Her iki yerleşim de çalışır: tek üst düzey girdi olarak klasör ya da doğrudan içeriği; arşivde bir adet .claude-plugin/plugin.json olduğu sürece (benimki 3.067 bayttı). Ardından Customize, Plugins, Add, Upload plugin yoluna gidin ve zip dosyasını seçin.

Yeni eklenen bir eklenti, açık olan değil, bir sonraki Cowork görevinize yüklenir; bu yüzden onu aramadan önce yeni bir görev başlatın. Yeni görevde de görünmüyorsa, dosyaları hata ayıklamaya başlamadan önce masaüstü uygulamasını kapatıp açın.

Eklentiyi Claude Code üzerinden claude --plugin-dir ./weekly-metrics-report ile test ettim, shop.db’ye işaret ettim ve /weekly-metrics-report:weekly-report yazdım. Claude, 28 Eylül 2026’nın bir Pazartesi olduğunu buldu, 21 Eylül haftasını raporladı ve weekly_report_2026-09-21.md dosyasını yazdı. Özetinin tamamı şöyle:

Net revenue rose to $46,774.42, up +33.3% from $35,087.07 the week before. Completed orders went from 61 to 78, and average order value rose slightly to $599.67 (+4.3%). 
The biggest mover was Home Office: its net revenue went up +61.7% ($7,864.22 → $12,715.72), the largest gain in both dollars and percent. 
Fitness was the only category that fell (-15.2%). 
The refund rate rose from 10.3% to 12.4%, and Home Office's refund rate reached 27.6% (8 refunded orders), which is worth a closer look.

Ve aynı dosyadaki kategori tablosu:

Adım 2’deki pivot tablonun son satırı ile buradaki "Bu hafta" sütununu karşılaştırın: aynı 5 sayı, iki farklı eklentiden; çünkü ikisi de net gelirin aynı tanımını izledi.

Claude ayrıca istemediğim 2 şey yaptı. Kategori başına gürültülü karşılaştırma kuralımı kategori bazında uygulayarak, 5 kategorinin 4’ünde en az 1 haftada 20’den az tamamlanmış sipariş olduğunu işaretledi. Ayrıca, "değişimleri yüzde olarak raporla" kuralımın zaten yüzde olan iade oranı için muğlak olduğunu belirtti; bu yüzden onu yüzde puanı olarak raporladı.

Bunların ikisi de sonraki adımda beceriye yapacağım düzenlemeler; Şekil 3’teki döngü budur: bir satırı değiştir, sürümü artır, tekrar yükle.

Rapor çalıştıktan sonra, herhangi bir Cowork görevinde /schedule yazın; böylece siz olmadan her Pazartesi sabahı çalışır; çünkü zamanlanmış görevler Anthropic’in bulutunda çalışır. 1 Ekim 2026’dan beri, kuruluşunuz izin verdiğinde Claude’un oluşturduğu zamanlanmış görevler varsayılan olarak "Automatically approve" durumundadır; bu da bağlayıcıyı salt-okunur tutmak için bir başka nedendir. Cowork Dispatch eğitimi, diğer seçeneği, bir görevi telefonunuzdan başlatmayı gösterir.

Bir Cowork eklentisini ekibinizle paylaşmak

Eklenti klasörü dağıtım birimidir; bu yüzden paylaşım, onu nereye koyduğunuz meselesidir. İçinde onu listeleyen bir marketplace.json bulunan bir GitHub deposuna gönderin ve URL’yi verdiğiniz herkes, Add ardından Add marketplace altında depoyu ekleyebilir.

Team ve Enterprise planlarında, bir sahip bunun yerine özel bir depoyu senkronlayabilir veya bir kuruluş pazar yerine zipler yükleyebilir ve her eklentiyi herkes veya belirli gruplar için kullanılabilir, varsayılan olarak kurulu veya zorunlu olarak ayarlayabilir. Üyeler, geliştirdikleri bir eklentiyi üç noktalı menüsünden paylaşabilir veya Publish to org ile gönderebilir ve yardım merkezindeki kuruluş eklentisi rehberi kalanını kapsar.

Bir Eklentinin Çıktısını Nasıl Doğrularsınız?

Bir eklentinin çıktısını, grafiğe güvenmeden önce sorguyu okuyarak, eklentinin dokunabileceği şeyleri sınırlayarak ve bir beceri tetiklenmediğinde nereye bakacağınızı bilerek doğrularsınız. Bunun hiçbirinin bir güvenlik ekibine ihtiyacı yok; 5 dakikalık bir alışkanlığa ihtiyacı var.

Grafikten önce kodu okuyun

Makûl görünen bir sorgu, sorduğunuz sorudan biraz farklı bir soruyu yanıtlayabilir. Adım 2 ile aynı soru için el ile yazdığım ve hatasız çalışan bir sorgu işte burada:

SELECT p.category,
       ROUND(SUM(oi.quantity * p.list_price), 2) AS revenue
FROM orders AS o
JOIN order_items AS oi ON oi.order_id = o.order_id
JOIN products AS p ON p.product_id = oi.product_id
WHERE o.order_date >= '2026-08-03' AND o.order_date < '2026-09-28'
GROUP BY p.category
ORDER BY p.category;

Her satırı katalog list_price ile fiyatlandırır; indirimi yok sayar ve asla status filtresi uygulamadığı için iade edilen ve iptal edilen siparişleri de sayar. Her iki sorguyu da shop.db üzerinde çalıştırmak, aşağıdaki toplamları verir; son sütun, kestirme yolun net geliri ne kadar abarttığını gösterir.

Her kategori %24 ila %33 arası abartılmıştır ve her iki sonucun çubuk grafiği de aynı derecede makûl görünür. Eklentinin sorgusu bunu doğru yaptı; çünkü beceri, erken filtreleme yapmasını ve şemayı okumasını söyledi.

50 satırlık bir sorguyu okumak hâlâ yavaş geliyorsa, SQL’de Yardımcı Veri Analisti yolumuz akıcılığa en hızlı yoldur. SQL sorgu optimizasyonu rehberi, write-query becerisinin izlediği uygulamaları açıklar; örneğin birleştirmeden önce filtreleme ve SELECT *’ten kaçınma gibi.

Bağlantıları salt-okunur tutun

Yazma yetkili bir ambar bağlayıcısı, tablolarınızı iki yönden riske atar: Claude’un bir isteği ("test siparişlerini temizle") silme talimatı olarak yanlış okuması ve Claude’un okuduğu bir belge veya web sayfasındaki metnin kendi talimatlarını taşıdığı prompt enjeksiyonu. Team ve Enterprise planlarında, üyelerin yazma yetkili bağlayıcı araçları için görev başına onayı atlamasına izin veren ayar varsayılan olarak kapalıdır.

Sert bir korkuluk için, kancalar Cowork ve Claude Code’da her araç çağrısından önce çalışır; bu yüzden bir bağlayıcının SQL’ini okuyup SELECT dışındakileri reddeden bir kanca, ulaşılması gereken desendir. Claude Code kancaları rehberimiz, bir kancanın nasıl yazılacağını gösterir. Bu makale için o kancayı geliştirmedim; bu yüzden güvenmeden önce kendi bağlayıcınızla test edin.

Bir beceri yanlış tetiklenir ya da hiç tetiklenmezse önce açıklamayı kontrol edin

Claude ön bilgiden karar verir; bu yüzden beceriyi açın ve açıklamasının içinde bulunduğunuz durumu ve kullandığınız kelimeleri adlandırıp adlandırmadığına bakın. Adlandırmıyorsa ekleyin.

Sonra gövdenin kendisinin çalıştığını doğrulamak için beceriyi / ile elle tetikleyin; eklentinin anahtarının açık olduğunu ve bağlayıcının “Connected” gösterdiğini kontrol edin ve bir eklentinin geçerli olana değil, bir sonraki göreve yüklendiğini unutmayın. En yaygın suçlu, dosyayı özetleyen, isteği tanımlamayan bir açıklamadır.

Ürünün durumunu bilin

Cowork, 9 Nisan 2026’dan beri genel kullanıma açık. Eklentiler 30 Ocak 2026’da araştırma ön izlemesi olarak sunuldu ve şimdi tüm ücretli planlarda kullanılabilir olarak listeleniyor. 11 Ağustos 2026’da Anthropic, Uygunluk API kapsamını masaüstü, web ve mobil ortamlardaki Cowork oturumlarına genişletti.

Yardım merkezinde şu an iki boşluk var: yerel masaüstü oturumu dökümlerinin henüz bir silme uç noktası yok ve OpenTelemetry izleme, "uyumluluk amaçlı denetim günlüklerinin yerini almaz."

Kuruluşunuz bir HIPAA’ya hazır Enterprise planında ABD sağlık verilerini işliyorsa, Cowork yalnızca bir yönetici HIPAA yapılandırmasını uyguladıktan sonra İş Ortaklığı Anlaşmanız kapsamında olur ve bu açıldığında Cowork bulutta çalışamaz. Verileriniz düzenlemeye tabi ise, bir eklenti üretim tablolarına dokunmadan önce uyumluluk ekibinizin onayını alın.

Son Düşünceler

Artık 3 eklentiniz var: kurduğunuz Data eklentisi, kendi tablo adlarınızla özelleştirdiğiniz kopya ve 5 dosyadan oluşturduğunuz haftalık rapor. Üçüncüsünü tutardım; çünkü her Pazartesi yapıştırılan 40 satırlık bağlamı içerir—hem de yalnızca bir kez.

Bir eklentinin ne zaman geliştirmeye değer olduğuna karar vermek için ilke kısa: iş akışı tekrar ettiğinde ve bağlam sabit kaldığında eklentiye değer; bu da bir haftalık raporu, sözleşme inceleme kontrol listesini veya satış görüşmesi hazırlığını tanımlar. Tek seferlik bir analiz eklenti gerektirmez; bağlamı yapıştırın ve devam edin. 

Ve şirketinizde hangi tekrarlayan iş akışlarının önce bu muameleyi hak ettiğini tartıyorsanız, İş Dünyası için Üretken Yapay Zekâ kursumuz tam olarak bu soruya odaklanır. Tüm bunların arkasındaki modele daha derinlemesine girmek için, Claude Modellerine Giriş kursu, Claude API ile istem yazımı ve çok turlu çalışmayı kapsar.