개발자가 Node.js 및 TypeScript 프로젝트에서 Genkit 프레임워크를 올바르게 사용하는 데 도움이 필요한 경우가 많습니다. 이 스킬은 Genkit을 사용하여 AI 기반 애플리케이션을 구축하기 위한 참조 문서, 일반적인 오류 해결 방법 및 코드 패턴을 제공합니다.
스킬 ZIP 다운로드
Claude에서 업로드
설정 → 기능 → 스킬 → 스킬 업로드로 이동
토글을 켜고 사용 시작
테스트해 보기
"developing-genkit-js" 사용 중입니다. Google AI 제공업체와 함께 새 Genkit 프로젝트 설정
예상 결과:
- 소스 폴더에 ai 디렉토리 생성
- genkit 및 @genkit-ai/google-genai 패키지 설치
- genkit() 초기화 및 googleAI 플러그인이 포함된 genkit.ts 생성
- 정리를 위한 flows 및 tools 하위 디렉토리 생성
- Dev UI 접근을 위해 package.json에 genkit:ui 스크립트 추가
- GEMINI_API_KEY 환경 변수 설정
"developing-genkit-js" 사용 중입니다. pre-1.0 임포트와 함께 defineFlow 사용 시 ValidationError 해결
예상 결과:
- `import { defineFlow } from "@genkit-ai/flow"`를 ai 인스턴스에서 플로우 정의 방식으로 변경
- `import { genkit } from "@genkit-ai/core"`를 `import { genkit } from "genkit"`으로 변경
- `configureGenkit()`을 `const ai = genkit({ plugins: [...] })`으로 변경
- `response.text()` 메서드 대신 `response.text` 속성으로 응답 텍스트에 접근
- `npx tsc --noEmit`로 타입 체크를 실행하여 마이그레이션이 완료되었는지 확인
보안 감사
낮은 위험All 194 static analyzer findings are false positives. The skill consists entirely of markdown documentation and code examples for the Genkit JS framework. The 176 'external_commands' detections are markdown inline code spans (backtick formatting) showing CLI commands like `genkit --version` and `npx tsc --noEmit`, not actual shell execution. The 'weak cryptographic algorithm' findings have no corresponding crypto operations in the source. The 'hardcoded URL' findings are documentation references (localhost dev UI and example.com placeholder). The 'env_access' finding is documentation instructing users to set API keys. No executable code exists in this skill. Safe to publish.
낮은 위험 문제 (4)
품질 점수
만들 수 있는 것
새 Genkit 프로젝트 설정
개발자가 Genkit을 사용하여 기존 Node.js 애플리케이션에 AI 기능을 추가하려고 합니다. 이 스킬은 디렉토리 구조, 패키지 설치, 플러그인 구성 및 초기 플로우 생성을 안내합니다.
Genkit pre-1.0에서 v1.x로 마이그레이션
팀이 v1.0 릴리스 이전에 구축된 Genkit 애플리케이션을 유지보수하고 있습니다. 이 스킬은 지원 중단된 API를 식별하고 임포트, 모델 참조 및 플로우 정의에 대한 마이그레이션 패턴을 제공합니다.
멀티모달 AI 기능 구축
제품 팀이 애플리케이션에 이미지 생성 또는 텍스트 음성 변환 기능을 추가하려고 합니다. 이 스킬은 올바른 구성이 포함된 Gemini 멀티모달 모델에 대한 작동 예시를 제공합니다.
이 프롬프트를 사용해 보세요
Genkit을 사용하여 Node.js 프로젝트에 AI 기능을 추가하려고 합니다. 프로젝트 구조 설정, 필요한 패키지 설치 및 텍스트를 생성하는 간단한 플로우 작성을 도와주세요.
Genkit 플로우에서 TypeScript 오류가 발생하고 있습니다. 일반적인 오류 참조를 확인하고 이것이 지원 중단된 API 문제인지 임포트 문제인지 식별하는 것을 도와주세요.
Zod 스키마를 사용하여 구조화된 JSON 출력을 반환하는 Genkit 플로우가 필요합니다. 스키마 정의, 플로우 생성 및 타입 지정된 출력에 접근하는 방법을 보여주세요.
Gemini 2.5 Flash Image 모델을 사용하여 이미지를 생성하고 부분 결과를 스트리밍하는 Genkit 플로우를 만들고 싶습니다. 올바른 responseModalities 구성을 포함하고 미디어 출력을 처리하는 방법을 설명해주세요.
모범 사례
- Genkit API는 버전 간에 자주 변경되므로 내부 지식보다 Genkit CLI(`genkit docs:search`, `genkit docs:read`)를 사용하여 최신 문서를 조회하세요.
- API 키 및 민감한 구성 정보는 환경 변수나 .env 파일에 저장하세요. 소스 파일에 자격 증명을 하드코딩하거나 버전 관리 시스템에 커밋하지 마세요.
- 모든 입력 및 출력 정의에 standalone `zod` 패키지가 아닌 `genkit` 패키지의 Zod 스키마를 사용하세요. LLM이 스키마 필드를 올바르게 채우도록 안내하기 위해 `.describe()` 주석을 추가하세요.
피하기
- `@genkit-ai/core`, `@genkit-ai/ai` 또는 `@genkit-ai/flow`와 같은 지원 중단된 패키지에서 임포트하지 마세요. 핵심 기능은 직접 `genkit` 패키지에서 임포트하세요.
- 문제 해결 시 일반적인 오류 참조를 읽는 것을 건너뛰지 마세요. 많은 오류가 문서화된 해결책이 있는 지원 중단된 API 사용으로 인해 발생합니다.
- `gemini-2.0-*` 또는 `gemini-1.5-*`와 같은 사용 중단된 모델 버전을 사용하지 마세요. 항상 모범 사례 참조에 지정된 최신 세대 모델을 사용하세요.