coreyhaines31/makerskills

makerskills – 솔로 창업자 및 인디 운영자를 위한 AI 에이전트 "기술" 라이브러리

개요

• Claude Code 플러그인(Codex 또는 Cursor와 같은 다른 LLM 에이전트 호스트와 호환 가능)으로, 엄선된 "기술" 세트를 제공합니다. 각 기술은 에이전트가 슬래시 명령(예: /decide, /paste)을 통해 호출할 수 있는 문서화된 소규모 워크플로우입니다.
• 저장소에는 기술 정의(SKILL.md 파일)와 Claude가 기술을 호출하고, 결과를 저장하며, 한 기술에서 다른 기술을 구성할 수 있도록 하는 경량 런타임이 포함되어 있습니다.

중요성

• 현대 AI 에이전트는 질문에 답하는 데 뛰어나지만, 그 답변을 반복 가능하고 구조화된 워크플로우로 전환하는 것은 여전히 어렵습니다. makerskills는 의사 결정, 리서치, 도메인 이름 탐색, 개인 재무 모델링, 지식 베이스 관리, 콘텐츠 제작 등 일반적인 창업자 작업을 플러그 앤 플레이 에이전트 액션으로 변환하여 이 격차를 해소합니다.
• 각 기술은 문서 우선( SKILL.md에 트리거, 단계 및 버전이 설명됨)이므로 동일한 로직을 수동 또는 자동으로 실행할 수 있어 시스템이 투명하고 확장이 용이합니다.

핵심 개념

개념	설명
Skill	SKILL.md 파일에 설명된 독립형 워크플로우. 트리거 문구, 에이전트가 수행해야 할 단계 및 출력 저장 위치를 정의합니다.
Plugin install	Claude Code에서 마켓플레이스를 통해 플러그인을 추가하고(/plugin marketplace add coreyhaines31/makerskills), 설치합니다(/plugin install makerskills@makerskills). 로컬 개발용 심볼릭 링크도 작동합니다.
Configuration directory	개인 데이터는 저장소 외부의 ~/.config/makerskills/(또는 MAKERSKILLS_CONFIG를 통해 설정된 사용자 지정 경로)에 저장됩니다. 각 기술은 해당 위치의 자체 하위 폴더를 읽고 씁니다.
Composition	기술은 이름으로 다른 기술을 호출할 수 있습니다. 예를 들어, watch-video가 요약을 캡처하기 위해 second-brain을 호출하거나, business-brainstorm이 deep-research 및 domain을 호출할 수 있습니다.
Versioning	저장소에는 글로벌 semver 태그(예: v0.5.0)가 있습니다. 각 기술은 프론트매터 내에 자체 metadata.version을 포함하여 독립적인 반복이 가능합니다.

사용 방법

1. Claude Code에 플러그인을 설치합니다(로컬 개발을 위한 심볼릭 링크 포함).
2. 셸에서 MAKERSKILLS_CONFIG(및 볼트 위치를 위한 선택적 환경 변수)를 설정합니다.
3. 슬래시 명령(예: /decide)으로 기술을 호출합니다. 에이전트는 결정 컨텍스트를 묻고, 37signals 프레임워크를 실행하고, 날짜가 포함된 아카이브 파일을 작성합니다.
4. 해당 SKILL.md를 찾아 정확한 단계, 트리거 및 필요한 구성을 확인합니다.
5. 기술을 혼합하여 사용합니다. /business-brainstorm을 실행하여 아이디어를 검증한 다음, /domain으로 일치하는.com을 찾거나, /second-brain으로 리서치 내용을 개인 위키에 캡처합니다.

20개의 내장 기술 (그룹별)

• Meta utilities – skillify(기술 생성/적응/업데이트), toolify(API 또는 서비스 연결), loopify(반복적인 에이전트 루프 예약).
• Decision & strategy – decide, unstuck, maker-council, business-brainstorm, domain, deep-research.
• Knowledge & consumption – second-brain, company-brain, read-book, watch-video.
• Content creation – jab-hook(소셜 포스트 로테이션), slide-deck.
• Operations & utilities – pm(개인용 칸반), personal-cfo, company-cfo, paste(정리된 출력), social-fetch.

아키텍처 스냅샷

• 플러그인은 기술 파일에 대한 경량 래퍼입니다. 무거운 작업(웹 검색, API 호출, 브라우저 자동화)은 Claude의 내장 도구(WebSearch, agent-browser 등)와 INSTALL.md 지침을 통해 설치된 외부 바이너리에 위임됩니다.
• 모든 영구 데이터는 사용자의 구성 디렉토리에 저장되어 저장소를 상태 비저장(stateless) 상태로 유지하고 안전하게 공유할 수 있게 합니다.
• 기술은 ## Composes with 섹션에 종속성을 선언하여 에이전트가 실행 시점에 호출 그래프를 해결할 수 있도록 합니다.

시작하기 리소스

• INSTALL.md – 환경 변수, 종속성 목록, 로컬 개발 설정.
• EXAMPLES.md – 각 기술에 대한 엔드 투 엔드 워크스루.
• ARCHITECTURE.md – 플러그인의 멘탈 모델과 기술 팩 간의 상호 운용성에 대한 심층 분석.
• CONTRIBUTING.md – 새로운 기술을 추가하거나 기존 기술을 개선하기 위한 가이드라인.

제작자

• Conversion Factory 및 Magister의 창립자인 Corey Haines가 MIT 라이선스 하에 저장소를 유지 관리합니다.

요약 makerskills는 Claude(및 유사한 LLM 에이전트)를 창업자를 위한 개인 운영 플랫폼으로 변환하여, 일반적으로 스프레드시트, 메모 및 임시 스크립트에 남아 있는 반복적이고 지식 집약적인 작업을 자동화할 수 있게 합니다. 각 워크플로우를 문서화되고 버전 관리된 기술로 노출함으로써, 이 프로젝트는 AI 어시스턴트를 자신의 "메이커" 워크플로우에 맞게 조정하려는 모든 사람에게 투명성과 확장성을 제공합니다.