Claude Code Skills-Creator로 Claude Code Skills 구축하는 방법

모든 커스텀 Claude Code 도구에 대해 SKILL.md 파일을 수동으로 작성하는 것은 2023년에 package.json을 손으로 작성하는 것과 같습니다. 번거롭고, 오류 발생 가능성이 높으며, 완전히 피할 수 있습니다. Skills-Creator는 자연어 설명을 프로덕션 준비가 된 스킬 정의로 변환하여 이 과정을 자동화합니다. 여기에는 MCP 서버 구성 및 매니페스트 생성이 완벽하게 포함됩니다. 당신이 원하는 것을 설명하면, Skills-Creator가 상용구 코드를 처리합니다.

Claude Code 스킬이란 무엇이며 Skills-Creator가 모든 것을 어떻게 바꾸는가?

Claude Code 스킬은 AI 어시스턴트의 기능을 코드 생성 이상으로 확장합니다. 스킬은 도구, 매개변수, 실행 로직을 Claude가 검색하고 호출할 수 있는 형식으로 패키징합니다. 모델 컨텍스트 프로토콜(MCP)이 이를 가능하게 하지만, SKILL.md 파일을 작성하려면 정밀한 YAML 프론트매터, 매개변수 스키마, 사용 예시가 반복적으로 필요합니다.

Skills-Creator는 이러한 반복을 제거합니다. 이는 메타 스킬입니다. 즉, 스킬을 구축하는 스킬이죠. "PostgreSQL 데이터베이스를 쿼리하고 형식화된 결과를 반환하는 스킬을 생성해 주세요"와 같은 상위 수준 설명을 제공하면 Skills-Creator는 다음을 생성합니다.

적절한 프론트매터가 포함된 완벽한 SKILL.md
매개변수 유효성 검사 스키마
사용 예시 및 반환 타입 정의
퍼블리싱을 위한 선택적 manifest.json

내부 도구를 구축하는 팀에게 이는 이전에는 하나를 출시하는 데 걸리던 시간에 10개의 커스텀 스킬을 출시할 수 있음을 의미합니다. 개인 개발자에게는 필수 매개변수 필드를 다시는 잊지 않아도 된다는 것을 의미합니다.

💡

아름다운 API 문서를 생성하는 훌륭한 API 테스트 도구를 원하십니까?

최고의 생산성으로 개발팀이 함께 작업할 수 있는 통합된 올인원 플랫폼을 원하십니까?

Apidog은 모든 요구 사항을 충족하며, 훨씬 더 저렴한 가격으로 Postman을 대체합니다!

버튼

전제 조건: 개발 환경 설정

Skills-Creator를 사용하기 전에 MCP 지원 기능이 있는 Claude Code와 스킬을 위한 디렉토리 구조가 필요합니다.

Claude Code 설치

아직 설치하지 않았다면, Claude Code CLI를 설치하세요.

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

설치 확인:

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

Claude Code에서 MCP 구성

구성 디렉토리와 파일을 생성하세요.

# 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로 첫 번째 스킬 구축하기: 단계별 안내

TypeScript 타입에서 OpenAPI 사양을 생성하는 스킬을 구축해 봅시다. 이는 백엔드 개발자에게 일반적인 요구 사항입니다.

1단계: Claude Code 시작 및 Skills-Creator 호출

claude

Claude가 로드되면 Skills-Creator를 사용할 수 있는지 확인합니다.

/list-tools

다음을 볼 수 있습니다.

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

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

코드로부터

// 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에게 매니페스트 생성을 요청하세요.

Create a manifest for the openapi-generator skill with license MIT, keywords openapi, typescript, backend, and repository URL https://github.com/your-org/openapi-generator-skill


이것은 ~/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": [...]
  }
}

생성된 파일 이해하기: SKILL.md 및 매니페스트

Skills-Creator는 단순히 YAML만 작성하는 것이 아니라 모범 사례를 적용합니다. 생성된 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
---

주요 필드:

name: 케밥 케이스여야 하며, MCP 서버당 고유해야 합니다.
description: Claude가 스킬 호출 시점을 결정하는 데 사용됩니다.
mcp.transport: 로컬용은 stdio, 원격 서버용은 http
tools: 각 도구는 호출 가능한 함수가 됩니다.

매개변수 스키마:

type: string, number, boolean, array, object
required: 부울
default: 선택적 기본값
description: Claude의 매개변수 선택에 중요합니다.

마크다운 본문

본문은 사용 패턴을 문서화합니다. Skills-Creator는 다음을 생성합니다.

헤더: # Skill Name
개요: 스킬이 하는 일
사용 예시: Claude 프롬프트를 보여주는 코드 블록
반환 형식: 예상되는 출력 구조

이 문서는 /help openapi-generator를 실행할 때 Claude Code에서 사용됩니다.

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와 같은 라이브러리를 사용하여 TypeScript AST를 파싱하세요.

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: `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');

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 출력을 볼 수 있습니다. 작동하지 않으면 Claude Code의 출력 패널에서 MCP 로그를 확인하세요.

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 읽기
새 도구 정의 추가
매니페스트 버전 업데이트
마크다운 본문에 마이그레이션 가이드 작성

스킬을 구축하는 스킬 구축하기

메타 스킬 연결

Skills-Creator를 내부적으로 사용하는 스킬을 구축할 수 있습니다. 예를 들어, 템플릿을 기반으로 새로운 스킬을 스캐폴딩하는 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}` };
});

버전 관리

Git에서 스킬 버전을 추적:

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

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를 자동화 파이프라인에 연결하여 전체 스택에 걸쳐 에이전트 기능을 확장하세요.

이러한 스킬이 API와 상호 작용할 때, Apidog으로 유효성을 검사하여 안정적인 에이전트-도구 계약을 보장하세요.

버튼