كيفية بناء مهارات Claude البرمجية باستخدام أداة Claude Code Skills-Creator

كتابة ملفات SKILL.md يدويًا لكل أداة Claude Code مخصصة تشبه كتابة package.json يدويًا في عام 2023—مملة، عرضة للأخطاء، ويمكن تجنبها تمامًا. يقوم Skills-Creator بأتمتة هذه العملية بتحويل الأوصاف باللغة الطبيعية إلى تعريفات مهارات جاهزة للإنتاج، مكتملة بتكوين خادم MCP وتوليد البيان. أنت تصف ما تريده؛ وهو يتولى العمل الروتيني.

ما هي مهارات Claude Code ولماذا يغير Skills-Creator كل شيء؟

مهارات Claude Code توسع قدرات مساعدك الذكي بما يتجاوز توليد الأكواد. تقوم المهارة بتجميع أداة، ومعلوماتها، ومنطق تنفيذها في تنسيق يمكن لـ Claude اكتشافه واستدعائه. يتيح بروتوكول سياق النموذج (MCP) ذلك، ولكن كتابة ملفات SKILL.md تتطلب مقدمة YAML دقيقة، ومخططات معلمات، وأمثلة استخدام—بشكل متكرر.

Skills-Creator يزيل هذا التكرار. إنها مهارة-فوقية (meta-skill): مهارة تبني المهارات. أنت تقدم وصفًا عالي المستوى مثل "أنشئ مهارة تستعلم قواعد بيانات PostgreSQL وتعيد نتائج منسقة،" وهي تولد:

ملف SKILL.md كامل بمقدمة صحيحة
مخططات التحقق من صحة المعلمات
أمثلة الاستخدام وتعريفات نوع الإرجاع
ملف manifest.json اختياري للنشر

بالنسبة للفرق التي تبني أدوات داخلية، يعني هذا أنه يمكنك شحن عشر مهارات مخصصة في الوقت الذي كان يستغرقه شحن مهارة واحدة. بالنسبة للمطورين الفرديين، يعني ذلك عدم نسيان حقل معلمة مطلوب مرة أخرى أبدًا.

💡

هل تريد أداة رائعة لاختبار واجهات برمجة التطبيقات (API) تولد توثيقًا جميلًا لواجهات برمجة التطبيقات؟

هل تريد منصة متكاملة وشاملة لفريق المطورين لديك للعمل معًا بـ أقصى إنتاجية؟

Apidog يلبي جميع متطلباتك، ويحل محل Postman بسعر أكثر اقتصادية بكثير!

زر

المتطلبات الأساسية: إعداد بيئة التطوير الخاصة بك

قبل استخدام Skills-Creator، تحتاج إلى Claude Code مع دعم MCP وهيكل دليل لمهاراتك.

تثبيت Claude Code

إذا لم تكن قد فعلت ذلك بالفعل، قم بتثبيت واجهة سطر الأوامر (CLI) الخاصة بـ Claude Code:

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

تحقق من التثبيت:

claude --version
# يجب أن يظهر شيء مثل >= 2.0.70

تكوين MCP في Claude Code

أنشئ دليل وملف التكوين:

# 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:

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

استنساخ مستودع Skills-Creator

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

ينشئ هذا المهارة في /path/to/skills-creator/dist/index.js. استخدم المسار المطلق في ملف config.json الخاص بك.

إعداد دليل مخرجات المهارات

mkdir -p ~/claude-skicks

متغير البيئة SKILLS_OUTPUT_DIR يخبر Skills-Creator أين يكتب المهارات التي تم توليدها.

بناء مهارتك الأولى باستخدام Skills-Creator: دليل تفصيلي خطوة بخطوة

دعنا نبني مهارة تولد مواصفات OpenAPI من أنواع TypeScript—وهي حاجة شائعة لمطوري الواجهة الخلفية.

الخطوة 1: تشغيل Claude Code واستدعاء Skills-Creator

claude

بمجرد تحميل Claude، تحقق من توفر Skills-Creator:

/list-tools

يجب أن ترى:

Available tools:
- skills-creator:generate-skill (توليد مهارة جديدة من الوصف)

الخطوة 2: وصف مهارتك

في موجه Claude، اكتب:

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 بتحليل هذا الوصف ويستخرج:

اسم المهارة: openapi-generator
الإدخال: واجهات TypeScript (ملفات أو كود خام)
المخرجات: OpenAPI 3.0 YAML
الميزات: مسارات، مخططات، أمثلة

الخطوة 3: مراجعة ملف SKILL.md الذي تم إنشاؤه

بعد بضع ثوانٍ، يكتب Skills-Creator ملف ~/claude-skills/openapi-generator/SKILL.md:

---
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

هذه المهارة تحول واجهات TypeScript إلى مواصفات OpenAPI 3.0.

## أمثلة الاستخدام

### من ملف
```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
```

`من الكود`

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

`تنسيق الإرجاع`

تعيد الأداة سلسلة YAML تحتوي على:

openapi: "3.0.0"
info: العنوان، الإصدار، الوصف
paths: مسارات CRUD المولدَة تلقائيًا
components.schemas: واجهات TypeScript كمخططات


الخطوة 4: توليد البيان (اختياري)

إذا كنت تخطط لنشر المهارة في سوق التطبيقات، اطلب من Skills-Creator توليد بيان:

أنشئ بيانًا لمهارة openapi-generator بترخيص MIT، وكلمات مفتاحية openapi, typescript, backend، وعنوان URL للمستودع https://github.com/your-org/openapi-generator-skill


ينشئ هذا ملف `~/claude-skills/openapi-generator/manifest.json`:

```json
{
  "name": "openapi-generator",
  "version": "1.0.0",
  "description": "يولد مواصفات OpenAPI 3.0 من TypeScript",
  "license": "MIT",
  "keywords": ["openapi", "typescript", "backend"],
  "repository": {
    "type": "git",
    "url": "https://github.com/your-org/openapi-generator-skill"
  },
  "mcp": {
    "transport": "stdio",
    "tools": [...]
  }
}

`فهم الملفات التي تم إنشاؤها: SKILL.md والبيان`

لا يقتصر Skills-Creator على كتابة YAML فقط—بل يفرض أفضل الممارسات. دعنا نحلل بنية ملف SKILL.md الذي تم إنشاؤه.

`كتلة المقدمة (Frontmatter Block)`

---
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
---

الحقول الأساسية:

name: يجب أن يكون بتنسيق kebab-case، فريد لكل خادم MCP
description: يستخدمه Claude لتحديد متى يستدعي المهارة
mcp.transport: stdio للمحلي، http للخوادم البعيدة
tools: تصبح كل أداة دالة قابلة للاستدعاء

مخطط المعلمة:

type: string, number, boolean, array, object
required: منطقي (Boolean)
default: قيمة افتراضية اختيارية
description: حاسم لاختيار Claude للمعلمات

`محتوى Markdown`

يوثق المحتوى أنماط الاستخدام. يقوم Skills-Creator بتوليد:

الرأس: # اسم المهارة
نظرة عامة: ما تفعله المهارة
أمثلة الاستخدام: كتل الأكواد التي تعرض أوامر Claude
تنسيق الإرجاع: هيكل المخرجات المتوقع

تُستخدم هذه الوثائق بواسطة Claude Code عند تشغيل /help openapi-generator.

`ملف Manifest.json`

يضيف البيان بيانات وصفية للمشاركة:

{
  "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": { ... }
}

لماذا يهم: عند النشر في سوق مثل SkillsMP، يتيح البيان البحث وإدارة الإصدارات.

`اختبار، تكرار، ونشر مهارتك المخصصة`

`الخطوة 1: تنفيذ منطق المهارة`

يقوم Skills-Creator بتوليد التعريف فقط. يجب عليك كتابة المعالج. أنشئ ~/claude-skills/openapi-generator/index.ts:

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 هي المكان الذي يوجد فيه منطق عملك. استخدم مكتبات مثل ts-morph لتحليل شجرة بناء الجملة المجردة (AST) لـ TypeScript.

`الخطوة 2: بناء خادم MCP`

أنشئ ~/claude-skills/openapi-generator/server.ts:

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: `أداة: ${name}`,
    inputSchema: {} // سيتم تجاوزها بواسطة SKILL.md
  }))
});

server.setRequestHandler('tools/call', async (request) => {
  const tool = tools[request.params.name];
  if (!tool) throw new Error(`أداة غير معروفة: ${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('خادم MCP لمولد OpenAPI قيد التشغيل');

`الخطوة 3: تحديث تكوين Claude Code`

وجّه Claude Code إلى خادم مهارتك:

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

`الخطوة 4: الاختبار في Claude Code`

claude

/list-tools

يجب أن ترى openapi-generator:generate-from-file و openapi-generator:generate-from-code.

قم بإجراء اختبار:

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

إذا نجح الأمر، سترى مخرجات YAML. وإلا، فتحقق من سجلات MCP في لوحة مخرجات Claude Code.

`الخطوة 5: التكرار باستخدام Skills-Creator`

إذا كنت بحاجة إلى إضافة أداة (مثل generate-from-database)، فلا تقم بتعديل SKILL.md يدويًا. قم بالتشغيل:

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 بما يلي:

قراءة ملف SKILL.md الحالي
إضافة تعريف الأداة الجديدة
تحديث إصدار البيان
كتابة دليل ترحيل في نص Markdown

`بناء مهارات تبني المهارات`

`سلسلة المهارات الفوقية`

يمكنك بناء مهارة تستخدم Skills-Creator داخليًا. على سبيل المثال، skill-bootstrapper الذي ينشئ مهارات جديدة بناءً على القوالب.

// server/api/bootstrap-skill.post.ts
export default defineEventHandler(async (event) => {
  const { name, template } = await readBody(event);
  
  // استدعاء Skills-Creator برمجيًا
  await $fetch('http://localhost:3001/generate-skill', {
    method: 'POST',
    body: {
      name,
      description: `إنشاء أولي لمهارة ${template}`,
      template
    }
  });
  
  return { success: true, skillPath: `~/claude-skills/${name}` };
});

`إدارة الإصدارات`

تتبع إصدارات المهارات في Git:

cd ~/claude-skills
git init
git add openapi-generator/
git commit -m "المهارة الأولية openapi-generator"

عندما يقوم Skills-Creator بتحديث مهارة، فإنه يزيد الإصدار في البيان. قم بتأكيد كل إصدار لإمكانية التراجع.

`اختبار المهارات برمجيًا`

// 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');
  });
});

قم بتشغيل الاختبارات قبل نشر تحديثات المهارة.

`نشر مهارتك`

`إلى سجل خاص`

حزّم مهارتك كحزمة npm:

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

يقوم فريقك بتثبيتها:

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

حدّث تكوين Claude Code:

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

`إلى سوق SkillsMP`

أنشئ حسابًا على skillsmp.com
قم بتشغيل skills-mp publish ~/claude-skills/openapi-generator
تقرأ واجهة سطر الأوامر (CLI) ملف manifest.json وتقوم بتحميل مهارتك

يمكن للمستخدمين التثبيت عبر:

skills-mp install openapi-generator

`الخلاصة`

يحوّل Skills-Creator تطوير المهارات من التكوين اليدوي إلى التوليد الآلي. أنت تصف النية، وهو ينتج القوالب الأساسية. أنت تركز على منطق العمل، وهو يتعامل مع توافق بروتوكول MCP. بالنسبة للفرق التي تبني تكاملات Claude Code مخصصة، يقلل هذا وقت التطوير بنسبة 80% ويضمن الاتساق عبر تعريفات المهارات. ابدأ بمهارة بسيطة اليوم، ثم ادمج Skills-Creator في مسارات عمل الأتمتة الخاصة بك لتوسيع قدرات الوكيل عبر مكدسك بالكامل.

عندما تتفاعل هذه المهارات مع واجهات برمجة التطبيقات (APIs) الخاصة بك، تحقق منها باستخدام Apidog لضمان عقود وكيل-أداة موثوقة.

زر