> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Beceriler

> AI'ye uygulamanız hakkında bilgi verin ve çağırabileceği araçlar sağlayın.

# Beceriler

Beceri, AI'ye uygulamanızla neler bildiğini ve neler yapabileceğini söyleyen bir **klasördür**. İçinde şunlar vardır:

* `SKILL.md` — AI'nin okuduğu talimatlar (gerekli).
* `tools.ts` — AI'nin çağırabileceği araçların listesi (isteğe bağlı).

`SKILL.md` uygulamayı ve araçlarını açıklar; `tools.ts` araçları bildirir; her araç uygulamanızın bileşenlerinden birindeki bir HTTP rotası tarafından uygulanır.

## Becerileri tanımlama

`kazzle.config.ts` dosyasını her becerinin `SKILL.md` dosyasına yönlendirin. Kazzle klasörünü kullanır, bu nedenle yanındaki `tools.ts` otomatik olarak alınır.

```typescript theme={"theme":"material-theme-darker"}
import { defineConfig } from '@kazzle/app';

export default defineConfig({
  components: [{ name: 'api', type: 'process', path: './components/api/index.ts' }],
  skills: [
    { name: 'API guide', path: './skills/api/SKILL.md' },
  ],
});
```

## SKILL.md

Frontmatter'ı olan ve ardından AI'nin izlemesi gereken talimatları içeren Markdown.

```markdown theme={"theme":"material-theme-darker"}
---
name: API guide
description: Bu uygulamanın araçlarını nasıl kullanacağınız.
alwaysActive: true
---

Bir bağlantıyı kaydetmek için `save_bookmark` kullanın. Bir onay döndürür.
```

## tools.ts

Bir `SKILL.md` dosyasının yanındaki `tools.ts`, o becerinin çağırabileceği araçları bildirir. Tam araç sözleşmesi — bildirim türleri, işleyici istek/yanıt şekli ve `content` ile `markdown` sonuç kanalları — [Araçlar](/apps/tools) sayfasında yer alır.

```ts theme={"theme":"material-theme-darker"}
import { z } from 'zod';
import type { KazzleTool } from '@kazzle/app/tools';

export const tools = [
  {
    name: 'save_bookmark',
    displayName: 'Save bookmark',
    description: 'Bir yer işareti URL'sini kaydedin ve bir onay döndürün.',
    input: z.object({ url: z.string().url(), title: z.string().optional() }).strict(),
    target: {
      type: 'app',
      component: 'api',
      path: '/tools/save-bookmark',
      method: 'POST',
      body: '${input}',
    },
  },
] as const satisfies readonly KazzleTool[];
```

## AI becerileri nasıl kullanır

AI, `SKILL.md` dosyasını isteğe bağlı olarak (tüm becerileri önceden değil) okuyarak yanıtlarını temellendirir ve `tools.ts` dosyasında bildirilen araçları çağırabilir. Eşleşen bir rotası olmayan bir araç hiçbir şey yapmaz; her ikisini birlikte ekleyin. `tools.json` desteklenmez.