Blog

Hướng dẫn xây dựng kỹ năng lập trình Claude với Claude Code Skills-Creator

Ashley Goolam

Ashley Goolam

21 tháng 1 2026

Hướng dẫn xây dựng kỹ năng lập trình Claude với Claude Code Skills-Creator

Viết thủ công các tệp SKILL.md cho mọi công cụ Claude Code tùy chỉnh có cảm giác giống như viết tệp package.json bằng tay vào năm 2023—tẻ nhạt, dễ mắc lỗi và hoàn toàn có thể tránh được. Skills-Creator tự động hóa quá trình này bằng cách biến các mô tả ngôn ngữ tự nhiên thành các định nghĩa kỹ năng sẵn sàng cho sản xuất, hoàn chỉnh với cấu hình máy chủ MCP và tạo manifest. Bạn mô tả những gì bạn muốn; nó xử lý phần mã mẫu.

Kỹ Năng Claude Code Là Gì Và Tại Sao Skills-Creator Thay Đổi Mọi Thứ?

Kỹ năng Claude Code mở rộng khả năng của trợ lý AI của bạn vượt ra ngoài việc tạo mã. Một kỹ năng đóng gói một công cụ, các tham số và logic thực thi vào một định dạng mà Claude có thể khám phá và gọi. Giao thức Ngữ cảnh Mô hình (MCP) làm cho điều này trở nên khả thi, nhưng việc viết tệp SKILL.md đòi hỏi phải có tiền tố YAML chính xác, lược đồ tham số và các ví dụ sử dụng—một cách lặp đi lặp lại.

Skills-Creator loại bỏ sự lặp lại đó. Nó là một kỹ năng meta: một kỹ năng xây dựng các kỹ năng. Bạn cung cấp một mô tả cấp cao như “Tạo một kỹ năng truy vấn cơ sở dữ liệu PostgreSQL và trả về các kết quả đã định dạng,” và nó sẽ tạo ra:

Đối với các nhóm xây dựng công cụ nội bộ, điều này có nghĩa là bạn có thể phát hành mười kỹ năng tùy chỉnh trong thời gian trước đây chỉ đủ để phát hành một kỹ năng. Đối với các nhà phát triển độc lập, điều này có nghĩa là không bao giờ quên một trường tham số bắt buộc nữa.

💡
Bạn muốn một công cụ kiểm thử API tuyệt vời có thể tạo ra Tài liệu API đẹp mắt?

Bạn muốn một nền tảng tích hợp, tất cả trong một để Đội ngũ phát triển của bạn làm việc cùng nhau với năng suất tối đa?

Apidog đáp ứng mọi yêu cầu của bạn và thay thế Postman với mức giá phải chăng hơn nhiều!
button

Điều Kiện Tiên Quyết: Thiết Lập Môi Trường Phát Triển Của Bạn

Trước khi sử dụng Skills-Creator, bạn cần Claude Code với hỗ trợ MCP và một cấu trúc thư mục cho các kỹ năng của mình.

Cài Đặt Claude Code

Nếu bạn chưa có, hãy cài đặt CLI của Claude Code:

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

Xác minh cài đặt:

claude --version
# Sẽ hiển thị một cái gì đó như >= 2.0.70

Cấu Hình MCP Trong Claude Code

Tạo thư mục cấu hình và tệp:

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

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

Thêm cấu hình máy chủ Skills-Creator:

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

Clone Kho Lưu Trữ Skills-Creator

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

Thao tác này xây dựng kỹ năng đến /path/to/skills-creator/dist/index.js. Sử dụng đường dẫn tuyệt đối trong tệp config.json của bạn.

Thiết Lập Thư Mục Đầu Ra Kỹ Năng

mkdir -p ~/claude-skicks

Biến môi trường SKILLS_OUTPUT_DIR cho Skills-Creator biết nơi ghi các kỹ năng được tạo ra.

Xây Dựng Kỹ Năng Đầu Tiên Của Bạn Với Skills-Creator: Hướng Dẫn Từng Bước

Hãy xây dựng một kỹ năng tạo thông số kỹ thuật OpenAPI từ các kiểu TypeScript — một nhu cầu phổ biến đối với các nhà phát triển backend.

Bước 1: Khởi Động Claude Code Và Gọi Skills-Creator

claude

Sau khi Claude tải xong, hãy xác minh Skills-Creator có sẵn:

/list-tools

Bạn sẽ thấy:

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

Bước 2: Mô Tả Kỹ Năng Của Bạn

Trong lời nhắc của Claude, gõ:

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 phân tích mô tả này và trích xuất:

Bước 3: Xem Lại Tệp SKILL.md Được Tạo Ra

Sau vài giây, Skills-Creator ghi ~/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 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

Từ Mã

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

Định Dạng Trả Về

Công cụ trả về một chuỗi YAML chứa:


### Bước 4: Tạo Tệp Manifest (Tùy Chọn)

Nếu bạn có kế hoạch xuất bản kỹ năng ra một thị trường, hãy yêu cầu Skills-Creator tạo một tệp manifest:

Tạo một manifest cho kỹ năng openapi-generator với giấy phép MIT, các từ khóa openapi, typescript, backend và URL kho lưu trữ https://github.com/your-org/openapi-generator-skill


Điều này tạo ra `~/claude-skills/openapi-generator/manifest.json`:

```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": [...]
  }
}

Tìm Hiểu Các Tệp Được Tạo Ra: SKILL.md Và Manifest

Skills-Creator không chỉ viết YAML — nó còn thực thi các phương pháp hay nhất. Hãy phân tích cấu trúc SKILL.md được tạo ra.

Khối Tiền Tố

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

Các trường chính:

Lược đồ tham số:

Nội Dung Markdown

Nội dung tài liệu các mẫu sử dụng. Skills-Creator tạo ra:

  1. Tiêu đề: # Tên Kỹ năng
  2. Tổng quan: Kỹ năng làm gì
  3. Ví dụ sử dụng: Các khối mã hiển thị lời nhắc của Claude
  4. Định dạng trả về: Cấu trúc đầu ra mong đợi

Tài liệu này được Claude Code sử dụng khi bạn chạy /help openapi-generator.

Tệp Manifest.json

Manifest thêm siêu dữ liệu để chia sẻ:

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

Tại sao điều này quan trọng: Khi bạn xuất bản lên một thị trường như SkillsMP, manifest cho phép tìm kiếm và quản lý phiên bản.

Kiểm Thử, Lặp Lại Và Triển Khai Kỹ Năng Tùy Chỉnh Của Bạn

Bước 1: Thực Hiện Logic Kỹ Năng

Skills-Creator chỉ tạo định nghĩa. Bạn phải viết trình xử lý. Tạo ~/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 });
  }
};

Hàm convertTypeScriptToOpenAPI là nơi chứa logic nghiệp vụ của bạn. Sử dụng các thư viện như ts-morph để phân tích cú pháp AST của TypeScript.

Bước 2: Xây Dựng Máy Chủ MCP

Tạo ~/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: `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');

Bước 3: Cập Nhật Cấu Hình Claude Code

Trỏ Claude Code đến máy chủ của kỹ năng của bạn:

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

Bước 4: Kiểm Thử Trong Claude Code

claude

/list-tools

Bạn sẽ thấy openapi-generator:generate-from-file và openapi-generator:generate-from-code.

Chạy một bài kiểm tra:

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

Nếu nó hoạt động, bạn sẽ thấy đầu ra YAML. Nếu không, hãy kiểm tra nhật ký MCP trong bảng điều khiển đầu ra của Claude Code.

Bước 5: Lặp Lại Với Skills-Creator

Nếu bạn cần thêm một công cụ (ví dụ: generate-from-database), đừng chỉnh sửa SKILL.md thủ công. Chạy:

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 sẽ:

  1. Đọc tệp SKILL.md hiện có
  2. Thêm định nghĩa công cụ mới
  3. Cập nhật phiên bản manifest
  4. Ghi một hướng dẫn di chuyển vào nội dung markdown

Xây Dựng Các Kỹ Năng Xây Dựng Các Kỹ Năng

Xích Liên Kỹ Năng Meta

Bạn có thể xây dựng một kỹ năng sử dụng Skills-Creator nội bộ. Ví dụ, một skill-bootstrapper tạo ra các kỹ năng mới dựa trên các mẫu.

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

Quản Lý Phiên Bản

Theo dõi các phiên bản kỹ năng trong Git:

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

Khi Skills-Creator cập nhật một kỹ năng, nó sẽ tăng phiên bản trong manifest. Commit mỗi phiên bản để khôi phục.

Kiểm Thử Kỹ Năng Một Cách Lập Trình

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

Chạy các bài kiểm tra trước khi triển khai các bản cập nhật kỹ năng.

Xuất Bản Kỹ Năng Của Bạn

Vào Một Kho Lưu Trữ Riêng Tư

Đóng gói kỹ năng của bạn dưới dạng gói npm:

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

Nhóm của bạn cài đặt nó:

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

Cập nhật cấu hình Claude Code:

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

Vào Thị Trường SkillsMP

  1. Tạo một tài khoản tại skillsmp.com
  2. Chạy skills-mp publish ~/claude-skills/openapi-generator
  3. CLI đọc manifest.json và tải kỹ năng của bạn lên
skillsmp marketplace

Người dùng sau đó có thể cài đặt thông qua:

skills-mp install openapi-generator

Kết Luận

Skills-Creator biến đổi việc phát triển kỹ năng từ cấu hình thủ công thành tạo tự động. Bạn mô tả ý định, nó tạo ra mã mẫu. Bạn tập trung vào logic nghiệp vụ, nó xử lý việc tuân thủ giao thức MCP. Đối với các nhóm xây dựng tích hợp Claude Code tùy chỉnh, điều này cắt giảm thời gian phát triển đến 80% và đảm bảo tính nhất quán giữa các định nghĩa kỹ năng. Hãy bắt đầu với một kỹ năng đơn giản ngay hôm nay, sau đó xích liên Skills-Creator vào các quy trình tự động hóa của bạn để mở rộng khả năng của tác nhân trên toàn bộ ngăn xếp của bạn.

Khi các kỹ năng đó tương tác với API của bạn, hãy xác thực chúng bằng Apidog để đảm bảo các hợp đồng tác nhân-công cụ đáng tin cậy.

button

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API

Đăng ký miễn phíTải xuống