OpenClaw, Hermes, Claude Code, Cursor에서 genspark-claw 에이전트 스킬 설치 및 사용 방법

genspark-claw란 무엇인가요?

genspark-claw는 Genspark Claw, OpenClaw, Hermes, Claude Code, Cursor를 위한 커뮤니티 제작 스킬 팩이자 명령줄 인터페이스입니다. 호환되는 AI 에이전트에 런타임 종속성이나 빌드 단계 없이 실용적인 기능을 추가하는, 읽기 쉬운 다섯 가지 SKILL.md 워크플로를 제공합니다.

이 프로젝트는 독립적으로 운영되며 Genspark, OpenClaw 또는 Nous Research와 제휴 관계가 없습니다. 스킬이 YAML 프런트매터가 포함된 일반 Markdown 파일이므로 지원되는 런타임에 설치하기 전에 내용을 확인하고, 검증하고, 수정할 수 있습니다.

주요 기능

• 프로덕션용 스킬 5개: 심층 리서치, 보고서 생성, 슬라이드 기획, 브라우저 자동화, 전화 통화 준비.
• 런타임 간 호환성: 동일한 스킬을 OpenClaw, Hermes, Claude Code, Cursor 또는 로컬 작업 공간에 설치할 수 있습니다.
• 런타임 종속성 없음: CLI는 Node.js 표준 라이브러리를 사용하며 Node.js 18 이상이 필요합니다.
• 보안 검증: 검증기가 스킬 구조를 확인하고 파이프로 연결된 원격 실행, base64 페이로드, 파괴적 명령과 같은 패턴을 표시합니다.
• MCP 지원: Claude Desktop, Cursor, Windsurf와 같은 MCP 클라이언트에 스킬 팩을 제공할 수 있습니다.
• 테스트 및 CI: Node.js 18, 20, 22와 Ubuntu, macOS, Windows를 대상으로 자동화된 테스트 및 CI 범위를 제공합니다.

번들 스킬 이해하기

패키지에는 다섯 가지 스킬이 포함되어 있으며, 각 스킬은 SKILL.md 파일이 있는 별도의 디렉터리에 저장됩니다.

• super-research: 질문을 세분화하고, 병렬 검색을 수행하며, 독립적인 출처 간 주장을 교차 검증하고, 인용이 포함된 보고서를 작성합니다.
• spark-report: 리서치, 메모 또는 대화를 경영진 요약, 비교 표, 인용 및 다음 단계가 포함된 완성도 높은 보고서로 변환합니다.
• spark-slides: 리서치 또는 아이디어를 주장 중심 제목, 발표자 노트 및 출처가 포함된 서사형 슬라이드 덱 개요로 변환합니다.
• claw-browser-anchor: 불안정한 화면 좌표 대신 DOM 선택자와 ARIA 역할을 사용해 브라우저 자동화의 안정성을 높이고, 검증 및 변경 복구를 지원합니다.
• call-prep: 통화 상대를 조사하고, 목표와 대안을 정의하며, 분기형 스크립트를 작성하고, 통화 후 요약을 구조화해 AI 전화 통화를 준비합니다.

CLI 설치 및 확인

사전 요구 사항

Node.js 18 이상을 설치합니다. 프로젝트에서는 공식 Node.js 다운로드 안내를 사용하는 것을 권장합니다. macOS에서는 먼저 Apple의 명령줄 도구를 설치합니다:

xcode-select --install

Linux 및 Windows 사용자는 macOS 명령줄 도구 설치 단계를 건너뛰어도 됩니다. 자체 호스팅 OpenClaw, Hermes, Claude Code 또는 Cursor와 함께 패키지를 사용할 수 있으므로 Genspark 구독은 필요하지 않습니다.

GitHub에서 설치

작업 디렉터리를 만들고 GitHub에서 직접 저장소를 설치한 다음 상태 점검을 실행합니다:

mkdir -p 'gensparkclaw' && cd 'gensparkclaw'
npm install github:breakstageaxe61/genspark-claw
npx genspark-claw doctor
npx genspark-claw list

doctor 명령은 환경과 런타임을 확인합니다. list 명령은 번들된 다섯 가지 스킬과 설명을 표시합니다.

에이전트 런타임에 스킬 설치

OpenClaw 또는 Genspark Claw

번들된 모든 스킬을 기본 OpenClaw 스킬 디렉터리에 설치합니다:

npx genspark-claw install all --target openclaw

이 명령은 스킬을 ~/.openclaw/skills/에 복사합니다. 자체 호스팅 OpenClaw 게이트웨이를 사용하는 경우 게이트웨이를 다시 시작하거나 새 세션을 시작해야 스킬을 사용할 수 있습니다. Genspark Claw에서는 스킬 패널을 통해 SKILL.md 파일을 가져오거나 node_modules/genspark-claw/skills/에서 복사합니다.

Hermes

다음 명령으로 모든 스킬을 Hermes에 설치합니다:

npx genspark-claw install all --target hermes

기본 대상 경로는 ~/.hermes/skills/입니다.

Claude Code 및 Cursor

런타임별 대상을 사용해 표준 스킬 디렉터리에 파일을 설치합니다:

npx genspark-claw install all --target claude
npx genspark-claw install all --target cursor

각 명령은 각각 ~/.claude/skills/ 및 ~/.cursor/skills/를 대상으로 합니다.

프로젝트 작업 공간에 설치

프로젝트 로컬 설치가 필요하다면 사용자 지정 디렉터리에 스킬 하나 또는 전체 팩을 설치합니다:

npx genspark-claw install super-research
npx genspark-claw install all --dir ~/my-agent/skills

파일을 쓰지 않고 설치 프로그램의 작업을 확인하려면 --dry-run을 사용합니다:

npx genspark-claw install all --target openclaw --dry-run

CLI 명령 사용

CLI는 검색, 설치, 검증, 진단 및 MCP 시작을 지원합니다:

genspark-claw <command> [options]

• list 번들된 모든 스킬을 나열합니다.
• info <skill> 스킬의 세부 정보와 전체 지침을 표시합니다.
• install [skill] 스킬 하나 또는 모든 스킬을 설치합니다.
• validate [path] SKILL.md 파일을 검증하며, 기본값은 번들된 스킬입니다.
• doctor 로컬 환경과 감지된 런타임을 확인합니다.
• runtimes 감지된 에이전트 런타임을 나열합니다.
• mcp MCP stdio 서버를 시작합니다.
• version 설치된 버전을 출력합니다.

예를 들어 설치하기 전에 스킬을 검사합니다:

npx genspark-claw info super-research

스킬 지침을 먼저 읽는 것은 특히 타사 에이전트 스킬을 사용할 때 유용한 보안 및 호환성 실천 방법입니다.

MCP 서버 연결

genspark-claw에는 종속성이 없는 Model Context Protocol 서버가 포함되어 있습니다. 이 서버는 list_skills, get_skill, validate_skill의 세 가지 도구를 제공합니다.

설치된 서버의 절대 경로를 사용하여 Claude Desktop MCP 구성에 서버를 추가합니다:

{
  "mcpServers": {
    "genspark-claw": {
      "command": "node",
      "args": ["/absolute/path/to/gensparkclaw/node_modules/genspark-claw/mcp/mcp-server.js"]
    }
  }
}

내장 자체 테스트를 실행하여 초기화, 도구 검색 및 도구 실행을 확인합니다:

node node_modules/genspark-claw/mcp/mcp-server.js --test

MCP 자체 테스트 통과: initialize, tools/list, tools/call 모두 정상입니다.

안전하게 스킬 검증

사용하기 전에 포함된 파일에 대해 검증을 실행합니다:

npx genspark-claw validate

사용자 지정 디렉터리도 검증할 수 있습니다:

npx genspark-claw validate ./my-skills

검증기는 필요한 스킬 스키마를 확인하고 보안 감사를 수행합니다. curl | bash, base64 페이로드, 파괴적인 명령과 같은 패턴을 표시합니다. 검증을 통해 위험을 줄일 수 있지만, 전체 SKILL.md를 읽고 에이전트의 자체 감사 또는 doctor 도구도 사용해야 합니다.

사용자 지정 스킬 생성 및 기여

사용자 지정 스킬은 SKILL.md 파일을 포함하는 디렉터리입니다. 프런트매터에는 name, description, version, triggers, compatibility 및 한 줄 형식의 메타데이터 JSON과 같은 필드를 정의해야 합니다. 문서 본문에는 번호가 매겨진 지침, 규칙, 오류 처리 및 출력 형식이 포함되어야 합니다.

1. 디렉터리와 파일을 생성합니다.
2. 저장소의 기여 가이드에 설명된 스킬 구조를 따릅니다.
3. npm run validate를 실행하여 스키마와 보안 규칙을 확인합니다.
4. npm test를 실행하여 자동화된 테스트 모음을 실행합니다.
5. 스킬을 공유하려면 풀 리퀘스트를 엽니다.

이 저장소는 clawhub publish를 사용하여 호환되는 스킬을 ClawHub에 게시하는 기능도 지원합니다. 동일한 일반 파일 형식은 Hermes 및 agentskills.io 호환 도구에서도 사용할 수 있도록 설계되었습니다.

프로그래밍 방식 API 사용

다른 Node.js 애플리케이션에 genspark-claw를 통합하는 경우 패키지를 require하고 공개 API를 호출합니다:

const gclaw = require('genspark-claw');

gclaw.listBundledSkills();
gclaw.findSkill('super-research');
gclaw.installSkills({ skill: 'all', target: 'hermes' });
gclaw.validateTarget('./my-skills/');
gclaw.runDoctor();

메서드는 자체 도구에서 사용할 수 있는 스킬 레코드, 검증 결과 또는 환경 확인 데이터를 반환합니다.

로컬에서 개발

프로젝트 자체를 작업하려면 저장소를 복제하고 테스트 및 검증 명령을 실행합니다:

git clone https://github.com/breakstageaxe61/genspark-claw.git
cd genspark-claw
npm test
npm run validate
node examples/quickstart.js
node mcp/mcp-server.js --test

프로젝트에 종속성이 전혀 없도록 설계되었으므로 개발에 npm install은 필요하지 않습니다. 주요 영역은 bin/의 CLI 진입점, src/index.js의 공개 API, skills/의 스킬, mcp/의 MCP 서버 및 test/의 테스트입니다.

결론

genspark-claw는 여러 AI 에이전트 환경에 재사용 가능하고 검사 가능한 워크플로를 추가하는 간단한 방법을 제공합니다. GitHub에서 설치하고 doctor 및 list를 사용하여 설정을 확인한 다음, 런타임 대상을 지정하여 스킬을 배포하고, 사용자 지정 또는 타사 지침을 도입하기 전에 validate를 사용하세요. 통합이 필요한 경우 내장 MCP 서버와 Node.js API를 통해 동일한 스킬 팩을 도구와 애플리케이션에서 사용할 수 있습니다.