Claude Kodlama Yetenekleri Nasıl Geliştirilir: Claude Kodlama Yetenekleri-Oluşturucu ile

Her özel Claude Code aracı için SKILL.md dosyalarını manuel olarak yazmak, 2023'te package.json'ı elle yazmak gibi hissettiriyor—zahmetli, hataya açık ve tamamen önlenebilir. Skills-Creator, doğal dil açıklamalarını MCP sunucu yapılandırması ve manifest oluşturma dahil olmak üzere üretime hazır beceri tanımlarına dönüştürerek bu süreci otomatikleştirir. Siz ne istediğinizi açıklarsınız; o da kalıplaşmış işleri halleder.

Claude Code Becerileri Nelerdir ve Skills-Creator Neden Her Şeyi Değiştiriyor?

Claude Code becerileri, yapay zeka asistanınızın yeteneklerini kod üretiminin ötesine taşır. Bir beceri, bir aracı, parametrelerini ve yürütme mantığını Claude'un keşfedebileceği ve çağırabileceği bir formata dönüştürür. Model Bağlam Protokolü (MCP) bunu mümkün kılar, ancak SKILL.md dosyalarını yazmak, hassas YAML ön bilgileri, parametre şemaları ve kullanım örneklerini—tekrar tekrar—gerektirir.

Skills-Creator bu tekrarı ortadan kaldırır. Bu bir meta-beceridir: beceriler oluşturan bir beceri. Siz “PostgreSQL veritabanlarını sorgulayan ve biçimlendirilmiş sonuçlar döndüren bir beceri oluştur” gibi üst düzey bir açıklama sağlarsınız ve o şunları oluşturur:

Uygun ön bilgilerle eksiksiz bir SKILL.md
Parametre doğrulama şemaları
Kullanım örnekleri ve dönüş tipi tanımlamaları
Yayınlamak için isteğe bağlı manifest.json

Dahili araçlar geliştiren ekipler için bu, eskiden bir beceri için harcanan sürede on özel beceriyi piyasaya sürebileceğiniz anlamına gelir. Tek başına çalışan geliştiriciler için ise, bir daha asla gerekli bir parametre alanını unutmamak demektir.

💡

Harika API Dokümantasyonu oluşturan mükemmel bir API Test aracı mı istiyorsunuz?

Geliştirici Ekibinizin maksimum verimlilikle birlikte çalışması için entegre, Hepsi Bir Arada bir platform mu istiyorsunuz?

Apidog tüm taleplerinizi karşılar ve Postman'ı çok daha uygun bir fiyata değiştirir!

button

Ön Koşullar: Geliştirme Ortamınızı Kurma

Skills-Creator'ı kullanmadan önce, MCP destekli Claude Code'a ve becerileriniz için bir dizin yapısına ihtiyacınız var.

Claude Code Kurulumu

Henüz yapmadıysanız, Claude Code CLI'yı kurun:

npm install -g @anthropic-ai/claude-code

Kurulumu doğrulayın:

claude --version
# Should show something like >= 2.0.70

Claude Code'da MCP Yapılandırma

Yapılandırma dizinini ve dosyasını oluşturun:

# macOS/Linux
mkdir -p ~/.config/claude-code
touch ~/.config/claude-code/config.json

# Windows
mkdir %APPDATA%\claude-code
echo {} > %APPDATA%\claude-code\config.json

Skills-Creator sunucu yapılandırmasını ekleyin:

{
  "mcpServers": {
    "skills-creator": {
      "command": "node",
      "args": ["/path/to/skills-creator/dist/index.js"],
      "env": {
        "SKILLS_OUTPUT_DIR": "~/claude-skills"
      }
    }
  }
}

Skills-Creator Deposunu Klonlama

git clone https://github.com/anthropics/skills.git
cd skills/skills/skill-creator
npm install
npm run build

Bu, beceriyi /path/to/skills-creator/dist/index.js konumuna oluşturur. config.json dosyanızda mutlak yolu kullanın.

Beceriler Çıkış Dizinini Ayarlama

mkdir -p ~/claude-skicks

SKILLS_OUTPUT_DIR ortam değişkeni, Skills-Creator'a oluşturulan becerileri nereye yazacağını söyler.

Skills-Creator ile İlk Becerinizi Oluşturma: Adım Adım Rehber

Arka uç geliştiricileri için yaygın bir ihtiyaç olan TypeScript tiplerinden OpenAPI spesifikasyonları oluşturan bir beceri oluşturalım.

Adım 1: Claude Code'u Başlatın ve Skills-Creator'ı Çağırın

claude

Claude yüklendiğinde, Skills-Creator'ın kullanılabilir olduğunu doğrulayın:

/list-tools

Şunu görmelisiniz:

Available tools:
- skills-creator:generate-skill (Generate a new skill from description)

Adım 2: Becerinizi Tanımlayın

Claude istemine şunu yazın:

Use the skills-creator tool to generate a skill called "openapi-generator" that takes TypeScript interface definitions and generates OpenAPI 3.0 YAML specs. The skill should accept file paths or raw TypeScript code as input and return a valid OpenAPI spec with paths, schemas, and example responses.

Skills-Creator bu açıklamayı ayrıştırır ve şunları çıkarır:

Beceri adı: openapi-generator
Girdi: TypeScript arayüzleri (dosyalar veya ham kod)
Çıktı: OpenAPI 3.0 YAML
Özellikler: yollar, şemalar, örnekler

Adım 3: Oluşturulan SKILL.md'yi İnceleyin

Birkaç saniye sonra, Skills-Creator ~/claude-skills/openapi-generator/SKILL.md dosyasını yazar:

---
name: openapi-generator
description: Generates OpenAPI 3.0 specifications from TypeScript interfaces
version: 1.0.0
author: Claude Skills Creator
mcp:
  transport: stdio
tools:
  generate-from-file:
    description: Generate OpenAPI spec from TypeScript file
    parameters:
      filePath:
        type: string
        description: Path to TypeScript file containing interfaces
        required: true
      includeExamples:
        type: boolean
        description: Include example values in schema
        default: true
  generate-from-code:
    description: Generate OpenAPI spec from raw TypeScript code
    parameters:
      code:
        type: string
        description: TypeScript interface definitions as string
        required: true
      title:
        type: string
        description: API title for the OpenAPI spec
        default: "Generated API"
---

# OpenAPI Generator Skill

This skill transforms TypeScript interfaces into OpenAPI 3.0 specifications.

## Usage Examples

### From File
```typescript
// Input: ~/project/src/types.ts
export interface User {
  id: number;
  name: string;
  email: string;
}

// Claude: Use openapi-generator with filePath "~/project/src/types.ts"
// Output: OpenAPI spec with User schema

Koddaki

// Claude: Use openapi-generator with code "export interface Product {...}" and title "Product API"
```

`Dönüş Biçimi`

Araç, aşağıdaki YAML dizisini döndürür:

openapi: "3.0.0"
info: Başlık, sürüm, açıklama
paths: Otomatik oluşturulmuş CRUD yolları
components.schemas: Şema olarak TypeScript arayüzleri


### Adım 4: Manifest'i Oluşturma (İsteğe Bağlı)

Beceriye bir pazar yerine yayınlamayı planlıyorsanız, Skills-Creator'dan bir manifest oluşturmasını isteyin:

openapi-generator becerisi için MIT lisanslı, openapi, typescript, backend anahtar kelimeleri ve https://github.com/your-org/openapi-generator-skill depo URL'si ile bir manifest oluşturun


Bu, `~/claude-skills/openapi-generator/manifest.json` dosyasını oluşturur:

```json
{
  "name": "openapi-generator",
  "version": "1.0.0",
  "description": "Generates OpenAPI 3.0 specs from TypeScript",
  "license": "MIT",
  "keywords": ["openapi", "typescript", "backend"],
  "repository": {
    "type": "git",
    "url": "https://github.com/your-org/openapi-generator-skill"
  },
  "mcp": {
    "transport": "stdio",
    "tools": [...]
  }
}

`Oluşturulan Dosyaları Anlamak: SKILL.md ve Manifest`

Skills-Creator sadece YAML yazmaz, aynı zamanda en iyi uygulamaları da uygular. Oluşturulan SKILL.md yapısını inceleyelim.

`Frontmatter Bloğu`

---
name: openapi-generator
description: Generates OpenAPI 3.0 specifications from TypeScript interfaces
version: 1.0.0
author: Claude Skills Creator
mcp:
  transport: stdio
tools:
  generate-from-file:
    description: Generate OpenAPI spec from TypeScript file
    parameters:
      filePath:
        type: string
        description: Path to TypeScript file containing interfaces
        required: true
---

Ana alanlar:

name: Kebab-case olmalı, MCP sunucusu başına benzersiz olmalı
description: Claude tarafından becerinin ne zaman çağrılacağına karar vermek için kullanılır
mcp.transport: Yerel için stdio, uzak sunucular için http
tools: Her araç çağrılabilir bir fonksiyon haline gelir

Parametre şeması:

type: string, number, boolean, array, object
required: Boole
default: İsteğe bağlı varsayılan değer
description: Claude'un parametre seçimi için kritik

`Markdown Gövdesi`

Gövde, kullanım kalıplarını belgeler. Skills-Creator şunları oluşturur:

Başlık: # Beceri Adı
Genel Bakış: Becerinin ne yaptığı
Kullanım Örnekleri: Claude istemlerini gösteren kod blokları
Dönüş Biçimi: Beklenen çıktı yapısı

Bu dokümantasyon, /help openapi-generator komutunu çalıştırdığınızda Claude Code tarafından kullanılır.

`Manifest.json`

Manifest, paylaşım için meta veri ekler:

{
  "name": "openapi-generator",
  "version": "1.0.0",
  "description": "...",
  "license": "MIT",
  "keywords": ["openapi", "typescript", "backend"],
  "repository": {
    "type": "git",
    "url": "https://github.com/your-org/openapi-generator-skill"
  },
  "mcp": { ... }
}

Neden önemli: SkillsMP gibi bir pazar yerine yayınladığınızda, manifest arama ve sürüm kontrolünü etkinleştirir.

`Özel Becerinizi Test Etme, Yineleme ve Dağıtma`

`Adım 1: Beceri Mantığını Uygulayın`

Skills-Creator yalnızca tanımı oluşturur. İşleyiciyi sizin yazmanız gerekir. ~/claude-skills/openapi-generator/index.ts dosyasını oluşturun:

import { z } from 'zod';
import { convertTypeScriptToOpenAPI } from './converter';

// Schema for tool parameters
const FileParams = z.object({
  filePath: z.string(),
  includeExamples: z.boolean().default(true)
});

const CodeParams = z.object({
  code: z.string(),
  title: z.string().default("Generated API")
});

// MCP Tool Handlers
export const tools = {
  'generate-from-file': async (params: unknown) => {
    const { filePath, includeExamples } = FileParams.parse(params);
    const fs = await import('fs');
    const code = fs.readFileSync(filePath, 'utf8');
    return convertTypeScriptToOpenAPI(code, { includeExamples });
  },
  
  'generate-from-code': async (params: unknown) => {
    const { code, title } = CodeParams.parse(params);
    return convertTypeScriptToOpenAPI(code, { title });
  }
};

convertTypeScriptToOpenAPI fonksiyonu, iş mantığınızın bulunduğu yerdir. TypeScript AST'yi ayrıştırmak için ts-morph gibi kütüphaneleri kullanın.

`Adım 2: MCP Sunucusunu Oluşturun`

~/claude-skills/openapi-generator/server.ts dosyasını oluşturun:

import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { tools } from './index';

const server = new Server({
  name: 'openapi-generator',
  version: '1.0.0'
}, {
  tools: Object.keys(tools).map(name => ({
    name,
    description: `Tool: ${name}`,
    inputSchema: {} // Will be overridden by SKILL.md
  }))
});

server.setRequestHandler('tools/call', async (request) => {
  const tool = tools[request.params.name];
  if (!tool) throw new Error(`Unknown tool: ${request.params.name}`);
  
  const result = await tool(request.params.arguments);
  return { content: [{ type: 'text', text: result }] };
});

const transport = new StdioServerTransport();
await server.connect(transport);
console.error('OpenAPI Generator MCP server running');

`Adım 3: Claude Code Yapılandırmasını Güncelleyin`

Claude Code'u becerinizin sunucusuna yönlendirin:

{
  "mcpServers": {
    "openapi-generator": {
      "command": "node",
      "args": ["~/claude-skills/openapi-generator/dist/server.js"]
    }
  }
}

`Adım 4: Claude Code'da Test Edin`

claude

/list-tools

openapi-generator:generate-from-file ve openapi-generator:generate-from-code görmelisiniz.

Bir test çalıştırın:

Use openapi-generator to create an OpenAPI spec from the file ~/project/src/models/User.ts

Eğer çalışırsa, YAML çıktısı görürsünüz. Çalışmazsa, Claude Code'un çıktı panelindeki MCP günlüklerini kontrol edin.

`Adım 5: Skills-Creator ile Yineleyin`

Bir araç eklemeniz gerekirse (örneğin, generate-from-database), SKILL.md dosyasını manuel olarak düzenlemeyin. Şunu çalıştırın:

Use skills-creator to add a new tool called generate-from-database to the openapi-generator skill. It should accept a database connection string and table name, then generate CRUD paths.

Skills-Creator şunları yapacaktır:

Mevcut SKILL.md'yi okuyacak
Yeni araç tanımını ekleyecek
Manifest sürümünü güncelleyecekyeni bir sürüm
Markdown gövdesine bir geçiş rehberi yazacak

`Becerileri Oluşturan Beceriler Oluşturma`

`Meta-Beceri Zincirleme`

Skills-Creator'ı dahili olarak kullanan bir beceri oluşturabilirsiniz. Örneğin, şablonlara dayalı yeni beceriler oluşturan bir skill-bootstrapper.

// server/api/bootstrap-skill.post.ts
export default defineEventHandler(async (event) => {
  const { name, template } = await readBody(event);
  
  // Call Skills-Creator programmatically
  await $fetch('http://localhost:3001/generate-skill', {
    method: 'POST',
    body: {
      name,
      description: `Bootstrap ${template} skill`,
      template
    }
  });
  
  return { success: true, skillPath: `~/claude-skills/${name}` };
});

`Sürüm Yönetimi`

Beceri sürümlerini Git'te takip edin:

cd ~/claude-skills
git init
git add openapi-generator/
git commit -m "Initial openapi-generator skill"

Skills-Creator bir beceriyi güncellediğinde, manifestteki sürümü artırır. Geri alma için her sürümü kaydedin.

`Becerileri Programatik Olarak Test Etme`

// test/skill.test.ts
import { describe, it, expect } from 'vitest';
import { tools } from '../openapi-generator/index';

describe('openapi-generator', () => {
  it('should generate spec from file', async () => {
    const result = await tools['generate-from-file']({
      filePath: './test/fixtures/User.ts',
      includeExamples: true
    });
    
    expect(result).toContain('openapi: 3.0.0');
    expect(result).toContain('User');
  });
});

Beceri güncellemelerini dağıtmadan önce testleri çalıştırın.

`Becerinizi Yayınlama`

`Özel Bir Kayıt Defterine`

Becerinizi bir npm paketi olarak paketleyin:

// package.json
{
  "name": "@your-org/openapi-generator-skill",
  "version": "1.0.0",
  "main": "dist/server.js",
  "bin": { "openapi-generator-skill": "./bin/start.js" }
}

Ekibiniz onu kurar:

npm install -g @your-org/openapi-generator-skill

Claude Code yapılandırmasını güncelleyin:

{
  "mcpServers": {
    "openapi-generator": {
      "command": "openapi-generator-skill"
    }
  }
}

`SkillsMP Pazaryerine`

skillsmp.com adresinden bir hesap oluşturun
skills-mp publish ~/claude-skills/openapi-generator komutunu çalıştırın
CLI, manifest.json dosyasını okur ve becerinizi yükler

Kullanıcılar daha sonra şuradan yükleyebilir:

skills-mp install openapi-generator

`Sonuç`

Skills-Creator, beceri geliştirmeyi manuel yapılandırmadan otomatik üretime dönüştürür. Niyetinizi açıklarsınız, o da kalıplaşmış kodları üretir. Siz iş mantığına odaklanırsınız, o da MCP protokol uyumluluğunu halleder. Özel Claude Code entegrasyonları geliştiren ekipler için bu, geliştirme süresini %80 oranında azaltır ve beceri tanımları arasında tutarlılık sağlar. Bugün basit bir beceriyle başlayın, ardından ajan yeteneklerini tüm yığınınızda ölçeklendirmek için Skills-Creator'ı otomasyon işlem hatlarınıza dahil edin.

Bu beceriler API'lerinizle etkileşime girdiğinde, güvenilir ajan-araç sözleşmelerini garanti etmek için onları Apidog ile doğrulayın.

button