hypercore

Hypercore Agent Skills

Claude Code · Codex · Cursor · Antigravity에서 그대로 쓰는 한국어 우선 AI 에이전트 스킬 모음.

Hypercore는 코드베이스 분석부터 릴리스까지의 반복 작업을 한 번에 줄여주는 32개 스킬을 한 패키지로 제공합니다. 각 스킬은 트리거, 워크플로, 검증 게이트가 명시되어 있어 어떤 CLI에서 호출해도 같은 의도로 동작합니다.

• 드롭인 설치: Claude Code 마켓플레이스에 한 줄, 다른 CLI에는 npx skills add 한 줄.
• 다중 CLI: Claude Code, Codex, Cursor, Antigravity에서 동일하게 사용.
• 한국어 우선: 모든 스킬에 한국어 사양이 정렬되어 있으며 영어 원본도 함께 유지.
• 검증 가능한 결과물: 각 스킬은 evidence/validation/stop-condition 계약을 따라 결과를 남깁니다.

Vercel Skills 구조 위에 만들어졌습니다.

호환성

런타임	설치 경로	비고
Claude Code	/plugin marketplace add + /plugin install	1순위 호환 — 모든 스킬 사용 가능
Codex CLI	codex plugin marketplace add + codex plugin add	플러그인 설치 지원 — 실행 호환은 스킬별 compatibility 참고
Cursor	npx skills add ... -a cursor	동일
Antigravity 등 기타	npx skills add ... (-a 생략 시 기본 대상에 포함)	npx skills 가 지원하는 에이전트

스킬별 호환은 아래 스킬 카탈로그 표의 호환 컬럼 또는 각 SKILL.md의 compatibility 필드에서 확인합니다.

설치

Claude Code 마켓플레이스 (권장)

Claude Code 안에서:

/plugin marketplace add https://github.com/alpoxdev/hypercore
/plugin install hypercore

설치가 끝나면 Claude Code가 32개 스킬과 메타데이터를 자동으로 인식합니다. 슬래시 명령으로 곧바로 호출할 수 있습니다 — 예: /git-maker, /readme-maker, /research.

Codex 플러그인

Codex CLI에서:

codex plugin marketplace add https://github.com/alpoxdev/hypercore
codex plugin add hypercore@hypercore

로컬 클론에서 검증하거나 설치할 때는 저장소 루트를 마켓플레이스로 추가합니다:

codex plugin marketplace add /path/to/hypercore
codex plugin add hypercore@hypercore

이 방식은 .agents/plugins/marketplace.json이 plugins/hypercore 소스를 가리키고, 해당 플러그인이 skills/ 미러를 포함하는 Codex 플러그인 구조입니다.

npx skills add (Cursor / Antigravity 등, 또는 레거시 Codex 설치)

기본 대상(지원되는 모든 에이전트)에 한 번에 설치:

npx skills add alpoxdev/hypercore --skill '*' -g -y

특정 에이전트만 설치:

npx skills add alpoxdev/hypercore --skill '*' -a codex -g -y
npx skills add alpoxdev/hypercore --skill '*' -a cursor -g -y

특정 스킬만 골라서 설치:

npx skills add alpoxdev/hypercore --skill git-maker --skill readme-maker -g -y

옵션 요약:

• --skill '*' — 모든 스킬 설치. --skill <이름>을 반복하면 골라서 설치.
• -g, --global — 사용자 전역 위치에 설치. 생략하면 현재 프로젝트(.claude/skills/ 등)에만 설치.
• -a <agent> — 특정 에이전트만 대상으로. 생략하면 기본 대상 모두.
• -y — 확인 프롬프트 건너뜀.

npx skills add의 기본 설치 범위는 프로젝트 로컬입니다. 시스템 전역에 등록하려면 -g를 명시하세요.

소스에서 직접 사용

레포를 클론해 그대로 가져다 써도 됩니다 (CI나 CLI 빌드/실행에는 별도 의존성이 필요하지 않습니다 — 스킬은 모두 마크다운입니다):

git clone https://github.com/alpoxdev/hypercore.git
# 원하는 스킬 디렉터리를 자신의 프로젝트로 복사
cp -R hypercore/skills/git-maker your-project/.claude/skills/

빠른 사용 예시

설치 후 자연어로 호출하거나 슬래시 명령으로 시작합니다.

/git-maker            # 변경 사항을 그룹별로 커밋하고 푸시까지 한 번에
/readme-maker         # 코드를 읽고 프로젝트의 실제 모양에 맞는 README 생성/리팩터
/research "<주제>"    # 출처가 있는 다중 소스 리서치 보고서
/prd-maker "<아이디어>"  # 다이어그램·플로우·와이어프레임을 포함한 기획 패키지
/pre-deploy           # 배포 전 lint/타입/빌드 게이트

자연어로도 트리거됩니다 — 예: "이 프로젝트 README 다시 써줘" → readme-maker, "방금 변경 사항 커밋하고 푸시" → git-maker.

스킬 카탈로그

용도별 분류입니다. 같은 스킬이 둘 이상의 그룹에 어울릴 수 있습니다.

스킬·문서 작성

스킬	설명	호환
skill-maker	유지보수하기 쉬운 Codex/AI 에이전트 스킬 생성 및 리팩터링	All
skill-tester	스킬 트리거/동작을 시나리오 기반으로 검증	All
autoresearch-skill	반복 실행과 이진 eval 기반으로 기존 스킬을 자동 최적화	All
readme-maker	코드베이스 분석 기반 README 생성 및 리팩터링	All
docs-maker	AI가 읽기 좋은 구조화된 문서/룰 팩 생성	All
prd-maker	증거 기반 Living PRD + 다이어그램·플로우·와이어프레임 생성	All
design-md-maker	프로젝트별 DESIGN.md 디자인 시스템 문서 생성 및 갱신	All

아키텍처 가드

스킬	설명	호환
nextjs-architecture	Next.js App Router 아키텍처 규칙 적용	All
hono-architecture	Hono 아키텍처 규칙 적용	All
tanstack-start-architecture	TanStack Start 아키텍처 규칙 적용	All
tanstack-start-security	TanStack Start 인증/세션/보안 규칙 적용	All
vite-architecture	Vite + TanStack Router 아키텍처 규칙 적용	All

빌드 · 배포 · 릴리스

스킬	설명	호환
pre-deploy	배포 전 lint/타입/빌드 검증	All
deploy-fix	빌드/CI/배포 장애 진단 및 수정	All
version-update	시맨틱 버전 업데이트 및 릴리스	All
autoresearch-code	반복 실험·이진 eval 기반 코드베이스 자동 최적화	All

Git 워크플로

스킬	설명	호환
git-commit	Conventional Commits 기반 커밋 생성	All
git-push	미푸시 커밋을 안전하게 리모트로 푸시	All
git-maker	커밋과 푸시를 한 번에 (worktree 인지)	All
git-worktree	Git worktree 생성/진입/정리, 병렬 에이전트 워크스페이스 관리	All
git-issue	GitHub issue 생성/재개와 matching branch 세션 전환	All

리서치 · 디버깅 · QA

스킬	설명	호환
research	다중 소스, 출처 추적 가능한 마크다운 리서치 보고서	All
qa	비개발자 이해관계자 요청 분석 및 기술 해석 후 구현	All
bug-fix	버그 분석 → 수리 옵션 제시 → 검증된 구현	All
crawler	Playwright + CDP 기반 웹 크롤링 플로우 설계 및 코드 생성	All

콘텐츠 · SEO

스킬	설명	호환
seo-maker	SEO / AEO / GEO 통합 분석 및 최적화 리포트	All

실행 보조