sanjay3290/ai-skills

AI 코딩 어시스턴트(AI coding assistants)를 위한 휴대 가능한 기술(skills) 모음입니다. Agent Skills Standard를 지원하는 모든 주요 AI 클라이언트에서 작동합니다.

클라이언트 (Client)	기술 디렉토리 (Skills Directory)	문서 (Documentation)
Claude Code	~/.claude/skills/ 또는 .claude/skills/	docs
Gemini CLI	~/.gemini/skills/ 또는 .gemini/skills/	docs
Google Antigravity	~/.gemini/antigravity/skills/ 또는 .agent/skills/	docs
Cursor	~/.cursor/skills/ 또는 .cursor/skills/	docs
OpenAI Codex CLI	~/.codex/skills/ 또는 .codex/skills/	docs
Goose	~/.config/goose/skills/ 또는 .goose/skills/	docs

기술 (Skill)	설명 (Description)
postgres	심층 방어 보안(defense-in-depth security)이 적용된 읽기 전용 PostgreSQL 쿼리
...

전체 Google Workspace MCP 서버를 대체할 수 있는 경량화된 대안입니다. 각 기술은 keyring을 통한 교차 플랫폼 토큰 저장과 함께 독립적인 OAuth 인증을 가집니다.

개인 Gmail 계정은 지원되지 않습니다. 이 기술들은 공식 Google Workspace MCP와 동일한 OAuth 인프라를 사용합니다. ⚠️ Google Workspace 계정이 필요합니다.

기술 (Skill)	설명 (Description)
google-chat	스페이스 목록 조회, 메시지 전송, DM, 스페이스 생성
...

— 오픈 Agent Skills 생태계를 위한 패키지 매니저(package manager)입니다. 단 한 번의 명령으로 어떤 AI 코딩 에이전트(AI coding agent)에도 기술을 설치할 수 있습니다. npx skills

# 사용 가능한 20개의 모든 기술 탐색
npx skills add sanjay3290/ai-skills --list
# 단일 기술 설치 (에이전트 자동 감지)
...

특정 에이전트의 기술 디렉토리에 설치하려면 -a를 사용하세요:

# Claude Code용으로 설치
npx skills add sanjay3290/ai-skills --skill postgres -a claude-code
# 여러 에이전트에 동시에 설치
...

기본적으로 기술은 현재 프로젝트 디렉토리에 설치됩니다. 전역(사용자 수준) 설치를 원하시면 -g를 사용하세요:

# 전역 설치 — 모든 프로젝트에서 사용 가능
npx skills add sanjay3290/ai-skills --skill imagen -g
# 프로젝트 설치 (기본값) — 현재 리포지토리(repo)로 범위 제한
...

기술 CLI는 40개 이상의 에이전트를 지원합니다. 가장 일반적인 에이전트들은 다음과 같습니다:

기술 CLI는 40개 이상의 에이전트를 지원합니다. 가장 일반적인 에이전트들은 다음과 같습니다:

Agent	-a 플래그	프로젝트 디렉토리	글로벌 디렉토리
Claude Code	claude-code	.claude/skills/	~/.claude/skills/
Gemini CLI	gemini-cli	.gemini/skills/	~/.gemini/skills/
Cursor	cursor	.cursor/skills/	~/.cursor/skills/
OpenAI Codex	codex	.codex/skills/	~/.codex/skills/
Goose	goose	.goose/skills/	~/.config/goose/skills/
GitHub Copilot	github-copilot	.github/skills/	~/.github/skills/
Google Antigravity	antigravity	.agent/skills/	~/.gemini/antigravity/skills/
모든 에이전트	'*'	auto-detected	auto-detected

# 설치된 스킬 목록 보기
npx skills list
# 업데이트 확인
...

# skills.sh 디렉토리에서 검색하기
npx skills find postgres
# 모든 커뮤니티 스킬 둘러보기
...

전체 커뮤니티 스킬 목록은 skills.sh를 방문하세요.

수동 설치 (대안)

git clone https://github.com/sanjay3290/ai-skills.git ~/.claude/skills/ai-skills

cp -r skills/postgres ~/.claude/skills/

ln -s /path/to/ai-skills/skills/postgres ~/.claude/skills/postgres

~/.claude/skills/는 사용 중인 에이전트에 맞는 디렉토리로 교체하세요 (위 표 참조).

각 스킬은 추가적인 설정이 필요할 수 있습니다:

스킬 디렉토리에 connections.json을 생성하고 데이터베이스 자격 증명을 입력하세요. postgres/README.md, mysql/README.md 또는 mssql/README.md를 참고하세요.

# 사용하는 모든 데이터베이스에 대한 드라이버 설치
pip install psycopg2-binary # PostgreSQL
pip install mysql-connector-python # MySQL
...

export GEMINI_API_KEY=your-api-key

Google AI Studio에서 무료 키를 받으세요.

참고: Deep Research 작업은 210분이 소요되며, 쿼리당 $2$5의 비용이 발생합니다.

export OUTLINE_API_KEY=your-api-key
export OUTLINE_API_URL=https://your-wiki.example.com/api # 선택 사항

Outline 위키 설정에서 API 키를 받으세요.

# CLI 설치 (일회성)
npm install -g @google/jules
# 인증 (브라우저 열림)
...

jules.google.com에서 GitHub 리포지토리(repos)를 연결하세요. Jules는 비동기식(asynchronously)으로 작동합니다. 태스크(task)를 생성하면 백그라운드에서 실행되며, 완료되면 결과를 가져오면(pull) 됩니다.

export MANUS_API_KEY=your-api-key

manus.im 설정에서 API 키를 받으세요. Manus는 심층 조사(deep research), 시장 분석(market analysis), 제품 비교(product comparisons), 그리고 시각화(visualizations)를 포함한 종합적인 보고서 생성에 탁월합니다.

pip install -r skills/elevenlabs/requirements.txt # PDF/DOCX 작업 시에만 필요

skills/elevenlabs/config.json 파일을 생성하거나 (config.example.json 참조), ELEVENLABS_API_KEY 환경 변수(env var)를 설정하세요. 여러 청크(multi-chunk)의 내레이션 및 팟캐스트를 위해서는 ffmpeg가 필요합니다.

API 키는 elevenlabs.io에서 받으세요.

export GOOGLE_TTS_API_KEY=your-api-key
pip install PyPDF2 python-docx # PDF/DOCX 파일 작업 시에만 필요

Cloud Text-to-Speech API를 활성화하고 GCP 프로젝트에서 API 키를 생성하세요. 여러 청크(multi-chunk)의 문서 및 팟캐스트를 위해서는 ffmpeg가 필요합니다.

pip install -r skills/notebooklm/requirements.txt
python -m playwright install chromium

최초 1회 로그인을 위해 python skills/notebooklm/scripts/auth_manager.py setup을 사용하세요.

pip install -r skills/atlassian/requirements.txt
# 옵션 A: MCP 서버를 통한 OAuth (권장)
python skills/atlassian/scripts/auth.py login --oauth
...

pip install keyring
# 옵션 A: OAuth (권장)
python skills/azure-devops/scripts/auth.py login --org MyOrganization
...

각 Google Workspace 스킬은 keyring 라이브러리와 최초 인증이 필요합니다:

# 종속성 설치 (1회성)
pip install keyring
# 필요한 스킬에 대해 인증 (브라우저가 열림)
...

토큰은 시스템 키링(system keyring)을 통해 안전하게 저장됩니다:

macOS: Keychain
Windows: Windows Credential Locker
Linux: Secret Service API (GNOME Keyring, KDE Wallet 등)

설치가 완료되면, 스킬은 사용자의 요청에 따라 자동으로 활성화됩니다. 그저 자연스럽게 요청하세요:

• "활성 사용자를 위해 내 운영 데이터베이스 (production database)를 쿼리해줘"

• "orders 테이블의 스키마 (schema)를 보여줘"

• "지난주 가입자 수는 얼마야?"

• "MySQL 스테이징 (staging) 데이터베이스의 테이블 목록을 보여줘"

• "SQL Server에서 상위 10개 주문을 보여줘"

• "산 너머로 해가 지는 이미지 생성해줘"

• "내 날씨 앱을 위한 앱 아이콘을 만들어줘"

• "내 랜딩 페이지 (landing page)에 사용할 히어로 이미지 (hero image)가 필요해"

• "EV 배터리의 경쟁 환경을 조사해줘"

• "React, Vue, Angular 프레임워크를 비교해줘"

• "Kubernetes의 최신 개발 동향은 뭐야?"

• "위키 (wiki)에서 배포 가이드를 검색해줘"

• "온보딩 (onboarding) 문서를 읽어줘"

• "API 사양 (spec)을 위한 새로운 위키 페이지를 만들어줘"

• "Jules에게 src/auth.js의 인증 버그를 수정하도록 시켜줘"

• "Jules에게 단위 테스트 (unit tests) 추가를 위임해줘"

• "Jules에게 API 모듈에 문서를 추가하라고 요청해줘"

• "내 Jules 세션을 확인해줘" / "Jules의 결과물을 가져와줘"

• "Manus를 사용하여 Mac용 최고의 4K 모니터를 조사해줘"

• "Manus에게 기술적 지표 (technical indicators)를 사용하여 AAPL 주식을 분석하도록 시켜줘"

• "EV 충전에 대한 시장 조사를 Manus에게 위임해줘"

• "Manus에게 AWS vs GCP vs Azure 가격을 비교해달라고 요청해줘"

• "이 PDF를 오디오로 낭독해줘"

• "이 문서로 팟캐스트를 만들어줘"

• "이 마크다운 (markdown) 파일을 음성으로 변환해줘"

• "사용 가능한 ElevenLabs 목소리 목록을 보여줘"

• "Google TTS를 사용하여 이 문서를 낭독해줘"

• "이 분석 내용으로 팟캐스트를 만들어줘"

• "이 마크다운을 오디오로 변환해줘"

• "사용 가능한 Google TTS 목소리 목록을 보여줘"

• "이 NotebookLM URL을 쿼리하고 핵심 사항을 요약해줘"

• "이 NotebookLM 링크를 주제와 함께 라이브러리에 추가해줘"

• "내 활성 노트북 (active notebook)에 대해 후속 질문을 해줘"

• "Jira에서 DEV 프로젝트의 열린 버그를 검색해줘"

• "로그인 버그 수정을 위한 Jira 태스크를 생성해줘"

• "JDP-255를 완료 (Done) 상태로 전환해줘"

• "Confluence에서 배포 가이드를 검색해줘"

• "SonarQube 제안 페이지를 읽어줘"

• "내 Azure DevOps 프로젝트 목록을 보여줘"

• "Sandbox 프로젝트에 버그 작업 항목 (work item)을 생성해줘"

• "메인 리포지토리 (main repo)의 열린 풀 리퀘스트 (pull requests)를 보여줘"

• "develop 브랜치에서 CI 파이프라인 (pipeline)을 실행해줘"

• "대기 중인 배포 승인 목록을 보여줘"

• "내 Google Chat 스페이스 목록을 보여줘" / "Project Alpha에 메시지를 보내줘"

• "프로젝트 제안서에 관한 새로운 Google Doc을 생성해줘"

• "내 Q4 예산 스프레드시트의 내용을 가져와줘"

• "내 내일 일정은 뭐야?"

• "지난달 인보이스(invoices)를 내 Gmail에서 검색해줘"

• "내 Drive에서 'report'라는 이름의 파일을 찾아줘"

모든 스킬은 Agent Skills Standard를 따릅니다:

skill-name/
├── SKILL.md # 필수: AI 에이전트를 위한 지침 (Instructions)
├── README.md # 사용자용 문서 (Human documentation)
...

SKILL.md 파일은 YAML frontmatter를 사용합니다:

---
name: skill-name
description: "이 스킬을 사용하는 시점"
...

• 이 저장소(repository)를 포크(Fork)하세요

• skills/your-skill-name/에 새로운 스킬을 생성하세요

• 적절한 frontmatter가 포함된 SKILL.md를 포함하세요

• README.md에 문서를 추가하세요

• 풀 리퀘스트(pull request)를 제출하세요

Google Workspace Skills- Gemini CLI 팀이 제작한 공식 Google Workspace MCP 서버를 기반으로 합니다. 인증을 위해 해당 팀의 OAuth 클라우드 함수(cloud function)를 사용합니다.

Apache-2.0