# 🌐 Dijimind AI Skill - URL ile İndirme ve Entegrasyon Kılavuzu

Bu kılavuz, Dijimind Yapay Zeka Yeteneklerini (`SKILL.md`, `dijimind-api-openapi.json`, `skills.json`) internet üzerinden doğrudan **URL ile indirme**, **sunucu üzerinden canlı yayınlama** ve **AI platformlarına (Gemini, Claude, ChatGPT, Cursor) dinamik bağlama** adımlarını içermektedir.

---

## 🔗 1. Canlı URL Bağlantıları (Live Endpoints)

Dijimind platformunda aşağıdaki dosyalar canlı olarak sunulmakta ve herhangi bir indirme veya tarayıcı üzerinden doğrudan erişilebilir durumdadır:

| İstenen Kaynak | Doğrudan Erişim URL'si | MIME Türü |
| :--- | :--- | :--- |
| **Ana Skill Dokümanı** | `https://dev.dijimind.com/SKILL.md` | `text/markdown` |
| **OpenAPI 3.0 API Şeması** | `https://dev.dijimind.com/dijimind-api-openapi.json` | `application/json` |
| **Skill Manifest Kataloğu** | `https://dev.dijimind.com/skills.json` | `application/json` |
| **Kullanım Kılavuzu** | `https://dev.dijimind.com/USER_GUIDE.md` | `text/markdown` |

---

## 📥 2. Terminal ve Komut Satırı ile İndirme (Download Commands)

Dijimind Skill dosyalarını yerel bilgisayarınıza veya bir sunucuya terminal üzerinden çekmek için aşağıdaki komutları kullanabilirsiniz:

### A. Linux / macOS (`curl` veya `wget`)
```bash
# SKILL.md indirme
curl -O https://dev.dijimind.com/SKILL.md

# OpenAPI Şemasını indirme
curl -O https://dev.dijimind.com/dijimind-api-openapi.json

# Skill Manifest Kataloğunu indirme
curl -O https://dev.dijimind.com/skills.json

# Kullanım Kılavuzunu indirme
curl -O https://dev.dijimind.com/USER_GUIDE.md
```

Alternatif olarak `wget` ile:
```bash
wget https://dev.dijimind.com/SKILL.md
wget https://dev.dijimind.com/dijimind-api-openapi.json
```

### B. Windows PowerShell
```powershell
Invoke-WebRequest -Uri "https://dev.dijimind.com/SKILL.md" -OutFile "SKILL.md"
Invoke-WebRequest -Uri "https://dev.dijimind.com/dijimind-api-openapi.json" -OutFile "dijimind-api-openapi.json"
```

---

## 🤖 3. URL ile Yapay Zeka Platformlarına Entegrasyon

### 🟢 A. OpenAI ChatGPT (Custom GPT Actions - URL Entegrasyonu)
ChatGPT Custom GPT oluştururken dosya yüklemenize gerek kalmadan doğrudan URL bağlayabilirsiniz:

1. **ChatGPT** -> **Explore GPTs** -> **Create** sekmesine gidin.
2. **Configure** sekmesinde alt kısımdaki **Actions** -> **Add Action** butonuna tıklayın.
3. **Import from URL** seçeneğini işaretleyin.
4. Şema URL alanına yapıştırın:
   ```text
   https://dev.dijimind.com/dijimind-api-openapi.json
   ```
5. **Import** butonuna bastığınızda tüm Dijimind API fonksiyonları (Sınav sonuçları, KTT üretimi, Görev takibi vb.) otomatik olarak yüklenecektir.
6. **Authentication** ayarını `Bearer` seçin.

---

### 🟣 B. Google Gemini & Google AI Studio (Web / API Integration)
Google Gemini ve AI Studio üzerinde URL üzerinden Skill entegrasyonu yapmak için:

1. **Google AI Studio** ortamında **System Instructions** bölümüne şu direktifi verin:
   > *"Sen Dijimind Eğitim Asistanısın. Kullanıcının öğrenci analizi taleplerini yanıtlarken `https://dev.dijimind.com/SKILL.md` ve `https://dev.dijimind.com/dijimind-api-openapi.json` adreslerindeki şema ve kuralları referans al."*
2. Gemini API veya Web tarayıcısında çalışan asistan, `https://dev.dijimind.com/SKILL.md` URL'sini canlı olarak okunabilir markdown kaynağı olarak kullanır.

---

### 🟠 C. Anthropic Claude (Claude Desktop / Claude Web / Code)
Claude Projects veya Web modunda:

1. **Claude.ai Projects** menüsünden **Add Content** -> **Add Web Page / URL** seçeneğini kullanabilirsiniz (veya URL içeriğini projeye aktarabilirsiniz).
2. URL bağlantılarını projeye tanımlayın:
   - `https://dev.dijimind.com/SKILL.md`
   - `https://dev.dijimind.com/dijimind-api-openapi.json`
3. Proje talimatlarında: *"Dijimind API entegrasyonu için https://dev.dijimind.com/SKILL.md rehberini uygula."* yazmanız yeterlidir.

---

### 💻 D. Cursor / Windsurf / Antigravity Remote Skill Entegrasyonu
IDE ve Agentik kodlama ortamlarında uzak skill manifestini eklemek için:

1. Projenizdeki `.agents/skills.json` dosyasında `inherits` veya `entries` kısmına URL manifestini tanımlayabilirsiniz:
   ```json
   {
     "inherits": [
       { "path": "https://dev.dijimind.com/skills.json" }
     ]
   }
   ```
2. Agent otomatik olarak `https://dev.dijimind.com/SKILL.md` adresini indirip hafızasına alacaktır.

---

## ⚙️ 4. Sunucu Yapılandırması ve Teknik Detaylar

Sunucunuzda Laravel `routes/web.php` içerisinde bu dosyalar dinamik olarak dış dünyaya sunulmaktadır. İlgili Laravel rota tanımları:

```php
Route::get('/SKILL.md', function() {
    return response()->file(base_path('../SKILL.md'), ['Content-Type' => 'text/markdown; charset=UTF-8']);
});

Route::get('/dijimind-api-openapi.json', function() {
    return response()->file(base_path('../dijimind-api-openapi.json'), ['Content-Type' => 'application/json; charset=UTF-8']);
});

Route::get('/skills.json', function() {
    return response()->json([
        "name" => "Dijimind AI Skills Catalog",
        "skills" => [[
            "name" => "dijimind-api",
            "skill_url" => "https://dev.dijimind.com/SKILL.md",
            "openapi_url" => "https://dev.dijimind.com/dijimind-api-openapi.json"
        ]]
    ]);
});
```

Bu sayede URL erişimleri her zaman güncel `SKILL.md` ve OpenAPI şemasını canlı servis eder.