---
name: user-skills
description: JSONPlaceholder API üzerinden kullanıcı bilgilerini sorgular, listeler ve detay getirir.
  Kullanıcı arama, listeleme veya profil sorgulama istendiğinde kullan.
---

## Description

Bu skill, harici REST API'den kullanıcı verilerini çekerek anlamlı bir şekilde sunar.
Detaylı API referansı, hata kodları ve çıktı formatları için resources/ klasörüne bakılır.

## Capabilities

- Tüm kullanıcıları listele
- ID'ye göre tekil kullanıcı getir
- Kullanıcıyı isme veya e-postaya göre filtrele
- Kullanıcının şirket ve adres bilgilerini göster

## When to Use

- "Tüm kullanıcıları listele" veya "kullanıcıları göster" istendiğinde
- "X isimli kullanıcıyı bul" gibi tekil sorgularda
- "ID'si 3 olan kullanıcının bilgileri nedir?" sorusunda
- Kullanıcı e-postası veya şirket bilgisi sorulduğunda

## Inputs

- `user_id` (opsiyonel): Tekil kullanıcı için numerik ID (1-10)
- `name_filter` (opsiyonel): İsme göre filtreleme için metin
- `email_filter` (opsiyonel): E-postaya göre filtreleme için metin
- Hiçbiri verilmezse tüm kullanıcılar listelenir

## Outputs

Çıktı formatlarının tamamı için `resources/OUTPUT_FORMATS.md` dosyasına bak.

## Resources

- `resources/API_REFERENCE.md` — Endpoint listesi, request/response örnekleri
- `resources/ERROR_CODES.md` — Olası hata kodları ve çözüm önerileri
- `resources/OUTPUT_FORMATS.md` — Başarılı ve hatalı yanıt formatları

## Instructions

1. Kullanıcının ne istediğini belirle: listeleme mi, tekil sorgu mu, filtreleme mi?
2. API detayları için `resources/API_REFERENCE.md` dosyasını oku.
3. İsteğe uygun endpoint'i çağır:
   - Listeleme → GET /users
   - Tekil → GET /users/{id}
   - Filtre → GET /users sonrası client-side filtrele
4. Hata alırsan `resources/ERROR_CODES.md` dosyasına bak ve kullanıcıyı bilgilendir.
5. Yanıtı `resources/OUTPUT_FORMATS.md` formatına göre düzenle ve Türkçe sun.