chubbyguan/chubbyskills

Chubby Skills – 크리에이터를 위한 로컬 지식 기반 툴킷

이것이 무엇인가

• 14개의 Agent Skills와 명령줄 인터페이스 모음으로, 비디오, 팟캐스트, 기사 및 로컬 문서를 캡처하고, 검색 가능한 Markdown 파일로 변환하며, 에이전트가 소비할 수 있는 증거 기반 자료 팩을 내보낼 수 있습니다.
• 핵심 워크플로우는 완전히 오프라인으로 작동 – 선택적 전사 또는 강화 기능을 활성화하지 않는 한 타사 패키지, API 키 또는 모델 다운로드가 필요하지 않습니다.

주요 기능

영역	할 수 있는 일
캡처	B站/YouTube에서 자막 가져오기, TikTok/抖音/微博/知乎 비디오 전사, X/Twitter 게시물 가져오기, WeChat 공개 기사 스크래핑, 로컬 Markdown/TXT/PDF(텍스트 레이어만) 가져오기.
가져오기 및 인덱싱	모든 것을 front-matter(제목, 소스 URL, 작성자, 타임스탬프, 좋아요 등)가 있는 Markdown으로 변환하고, 첨부 파일을 로컬에 저장하며, 검색 가능한 인덱스(키워드 + 선택적 시맨틱 라이트)를 구축.
검색 및 검색	키워드로 스니펫 찾기(선택적 벡터 저장소를 설치한 경우 시맨틱 검색 가능), 원본 줄 번호, 소스 URL 및 검증용 SHA-256 해시 확인.
내보내기	브리프 생성 – 정확한 발췌문, 줄 번호, 소스 메타데이터 및 해시를 포함하는 Markdown/JSON 패키지로, LLM 에이전트가 초안 작성 또는 주제 선택에 사용할 수 있습니다.
구독	RSS/YouTube 채널 또는 팟캐스트 구독을 설정하여 새 항목을 주기적으로 가져오고, 수집 대기열에 넣고, 선택적으로 일일 다이제스트 생성(LLM 불필요, 선택적 DeepSeek 요약).
에이전트 통합	지식 기반 스킬 패키지를 Claude Code, OpenCode 등과 같은 에이전트에 설치하거나, 검색, 검색 및 인덱싱 API를 제공하는 경량 MCP 서버를 실행.

시작 방법(빠른 실행)

1. 저장소를 클론하고 vault를 초기화합니다:

   git clone https://github.com/chubbyguan/chubbyskills.git
   cd chubbyskills
   python3 tools/chubby.py init --vault "$PWD/creator-vault"
   

2. 공개 X 게시물 캡처(추가 종속성 불필요):

   python3 tools/chubby.py ingest "https://x.com/OpenAI/status/1663696190960173056" --no-enrich
   python3 tools/chubby.py search "ChatGPT"
   

3. 소스 기반 브리프 내보내기:

   python3 tools/chubby.py brief --topic "ChatGPT" --output "$PWD/creator-vault/30_Output/brief.md"
   

   생성된 brief.md에는 정확한 발췌문, 줄 번호, 원본 URL 및 SHA-256 해시가 포함됩니다.

설치 옵션

• 제로 종속성 CLI – 클론 후 python3 tools/chubby.py … 직접 실행(Python 3.11+).
• 편집 가능한 패키지 – pip install -e .로 chubby 명령 사용 가능.
• 전체 스킬 설치 – python3 tools/install_skill.py --all --dest /path/to/agent/skills로 14개 스킬 디렉토리를 에이전트의 스킬 폴더에 복사.
• 선택적 추가 기능 – bash setup.sh light(Python만 확인), bash setup.sh video(ffmpeg 및 로컬 전사 모델 추가), bash setup.sh podcast(funasr 추가), 또는 플랫폼 기능 표에 나열된 yt-dlp, pymupdf 등을 설치.

일반적인 사용 사례

• 콘텐츠 크리에이터가 나중에 작성할 때 사용할 전체 인용 데이터가 포함된 소스 자료(트윗, YouTube 비디오, 팟캐스트)의 개인 아카이브를 유지해야 하는 경우.
• 연구자 / 지식 작업자가 원시 콘텐츠를 클라우드로 보내지 않고 LLM 에이전트가 쿼리할 수 있는 로컬 증거 기반을 구축하는 경우.
• 에이전트가 검색 가능한 지식 기반을 필요로 하는 경우 – MCP 서버는 search, read, index 및 기타 유틸리티를 노출하여 원활한 통합을 제공합니다.

제한 사항 및 주의 사항

• 플랫폼 스크래핑은 사이트의 공개 API를 존중합니다. 안티 스크래핑 조치를 우회하지 않습니다. 일부 사이트는 유효한 쿠키를 제공하지 않으면 미리보기만 반환할 수 있습니다(예: X 장문 기사).
• 비디오/오디오 전사는 외부 도구(ffmpeg, funasr, 선택적 Qwen-ASR)에 의존하며 첫 실행 시 모델을 다운로드해야 할 수 있습니다.
• 시맨틱 검색 및 콘텐츠 강화(요약, 태그)는 선택 사항이며 API 키(DeepSeek, OpenAI 등)가 필요합니다 – 핵심 오프라인 흐름의 일부가 아닙니다.
• PDF 가져오기는 텍스트 레이어만 추출합니다. 스캔된 PDF는 사전에 OCR이 필요합니다.
• 이 도구는 개인, 비상업적 용도로 사용됩니다. 콘텐츠를 저장하고 재사용할 때 저작권 및 플랫폼 약관을 존중해야 합니다.

더 알아보기

• 빠른 시작 가이드 및 자세한 문서는 docs/ 폴더에 있습니다(설치, 크리에이터 워크플로우, 구독, MCP 구성, 플랫폼 폴백 등).
• 예제 출력은 examples/README.md에 있습니다.
• 커뮤니티 토론, 버그 보고 및 기능 요청은 저장소의 Discussions 및 Issues 섹션에 있습니다.

---

Chubby Skills는 원시 인터넷 콘텐츠와 AI 에이전트에 직접 공급할 수 있는 구조화되고 인용이 풍부한 지식 기반 사이의 격차를 해소하면서, 데이터를 자신의 머신에 유지합니다.