🧰 promptbox 완전 정리: AI 코딩 에이전트 도구를 복사 한 번으로 쓰는 카탈로그

 
 

promptbox는 AI 코딩 에이전트용 프롬프트·스킬·훅·설정·MCP·CLI 도구를 카드 UI로 모아두고, 원문을 복사해 그대로 붙여 쓰도록 만든 오픈소스 카탈로그 사이트입니다.

Claude Code나 Codex를 며칠만 써 보면 비슷한 벽에 부딪힙니다. 좋은 스킬이나 훅이 있다는 이야기는 들었는데, 정작 그게 어느 깃허브 저장소에 있는지, 파일을 어디에 두어야 하는지, 내 에이전트가 그걸 언제 자동으로 불러오는지가 흩어져 있습니다. 결국 북마크만 늘고 실제로 설치한 도구는 두세 개에 그칩니다.

promptbox는 이 문제를 "검색" 대신 "복사"로 풉니다. 카테고리에서 도구를 고르고, 상세 페이지에서 원문 복사 버튼을 누르고, 에이전트 폴더나 채팅창에 붙여 넣으면 끝입니다. 설치할 것도, 로그인할 것도 없습니다.

2026년 8월 16일 확인 기준으로 저장소는 cskwork/promptbox이고 공개 사이트는 cskwork.github.io/promptbox입니다. 홈 화면은 9개 카테고리에 92개 항목을 담고 있다고 표시하며, 커밋은 115개, 마지막 푸시는 2026년 8월 16일입니다. 콘텐츠가 자주 늘어나는 저장소이므로 실제 항목 수는 방문 시점마다 달라집니다.

promptbox는 어떤 문제를 푸는가

promptbox는 새로운 AI 모델도, 새로운 코딩 에이전트도 아닙니다. 이미 쓰고 있는 에이전트에 넣을 "재료"를 모아 놓은 정적 사이트입니다.

에이전트 재료가 흩어지면 세 가지 비용이 생깁니다.

• 탐색 비용: 어떤 스킬이 쓸 만한지 판단하려면 저장소를 하나씩 열어 README를 읽어야 합니다.
• 설치 비용: 저장소마다 설치 방법이 다르고, 어떤 것은 스크립트가 기존 파일을 지웁니다.
• 유지 비용: 원본이 업데이트돼도 내가 복사해 둔 사본은 그대로 남습니다.

promptbox의 답은 단순합니다. 항목마다 큐레이션된 한국어 설명과 함께 바로 쓸 수 있는 원문을 코드 블록으로 붙여 둡니다. 상세 페이지의 "원문 복사" 버튼은 프런트매터를 뺀 본문 전체를 클립보드에 담습니다. 그래서 클립보드에 담긴 내용이 곧 SKILL.md 파일이거나, 채팅창에 그대로 붙여 넣을 프롬프트입니다.

에이전트 스킬 개념 자체가 낯설다면 Claude Code 하네스 효과적인 사용법을 먼저 읽으면 promptbox의 항목들이 어디에 꽂히는지 이해하기 쉽습니다.

9개 카테고리가 뜻하는 것

promptbox는 항목을 성격에 따라 9개로 나눕니다. 이름만 보면 비슷해 보이지만 "에이전트가 언제 읽는가"가 다릅니다.

카테고리	무엇인가	예시
프롬프트(prompts)	채팅창에 그대로 붙여넣는 템플릿	agents-quick-onboarding
스킬(skills)	한 가지 작업을 가르치는 SKILL.md, 특정 문장에 자동 발동	handoff, debug-code
플러그인(plugins)	여러 스킬·명령을 한 번에 설치하는 묶음	autoresearch, superpowers
하네스(harnesses)	코딩 에이전트 자체 또는 그 위의 실행 계층	jcode, oh-my-codex
훅(hooks)	도구 실행 전후에 끼어드는 스크립트	git-guardrails
설정(configs)	시작할 때 통째로 읽는 시스템 프롬프트 파일	AGENTS.md, CLAUDE.md
MCP(mcps)	외부 도구·데이터를 연결하는 서버 설정	codebase-memory-mcp
도구(tools)	에이전트 작업을 돕는 별도 CLI·앱	orca, officecli
오픈소스 앱(apps)	1인 기업·스타트업용 오픈소스 프로덕트	docmost, plane

여기서 스킬(skill)은 에이전트에게 한 가지 작업의 절차를 알려 주는 설명서 파일입니다. 사용자가 특정 표현을 쓰면 에이전트가 알아서 그 파일을 읽고 절차를 따릅니다. 훅(hook)은 반대로 사람이 부르지 않아도 도구 실행 전후에 자동으로 끼어드는 스크립트로, 위험한 git 명령을 막는 용도로 많이 씁니다.

저장소 기준으로 항목이 가장 많은 카테고리는 스킬입니다. src/content/skills/에만 60개 이상의 항목이 있고, 도구가 그다음입니다. 즉 promptbox는 사실상 "에이전트 스킬 모음집"에 주변 재료를 붙인 형태입니다.

MCP가 어떤 역할을 하는지 모른다면 MCP 입문 가이드를 함께 보면 mcps 카테고리의 설정 스니펫이 무엇을 연결하는지 명확해집니다.

한 방 온보딩 프롬프트: 가장 눈에 띄는 기능

promptbox 첫 화면의 "개발자 추천 — 여기서 시작"은 단순한 추천 목록이 아니라 설치 프롬프트 한 덩어리입니다. 이걸 복사해 Claude Code, Codex CLI, Gemini CLI 같은 에이전트 채팅창에 붙여 넣으면 에이전트가 직접 환경을 구성합니다.

핵심 설계는 ~/.agents/를 단일 출처로 만드는 것입니다.

• 추천 스킬을 ~/.agents/skills/ 아래에 한 벌만 설치합니다.
• 설치된 각 CLI의 스킬 디렉터리에는 심링크만 연결합니다.
• 공통 규칙 파일(AGENTS.md)도 같은 방식으로 공유합니다.

같은 스킬을 도구마다 복사해 두면 나중에 어떤 사본이 최신인지 알 수 없게 됩니다. 심링크 방식은 원본 하나만 갱신하면 모든 에이전트가 같은 내용을 봅니다.

프롬프트 본문에는 안전 규칙도 함께 들어 있습니다. 눈여겨볼 만한 것은 이 세 가지입니다.

• 설치 판정 기준: 디렉터리 존재가 아니라 SKILL.md가 읽히고 비어 있지 않은지로 판단합니다. 중단된 설치는 이름만 맞는 빈 디렉터리를 남기기 때문입니다.
• 파괴 금지: 이번 실행에서 만들지 않은 경로에 재귀 삭제를 하지 않고, 교체할 때는 타임스탬프 백업 디렉터리로 옮깁니다.
• 전역 범위 확인: 전역 설치라고 주장하면서 현재 저장소 안에 파일을 쓰는 설치 스크립트가 있으므로, 먼저 드라이런으로 파일 목록을 확인하라고 지시합니다.

기본 묶음에는 handoff 스킬이 포함됩니다. 작업 상태를 파일로 남겨 세션을 중단·재개하거나 다른 에이전트에게 넘길 때 쓰는 스킬입니다. 여러 에이전트를 동시에 굴리는 구성이 궁금하다면 SwarmForge 완전 정리가 핸드오프 프로토콜의 실제 사례를 보여 줍니다.

한 가지 주의할 점이 있습니다. 이 프롬프트는 에이전트에게 홈 디렉터리 아래 파일을 만들고 심링크를 걸 권한을 줍니다. 백업과 멱등성(같은 작업을 여러 번 실행해도 결과가 같은 성질)을 강조하고는 있지만, 실행 전에 프롬프트 본문을 직접 읽고 어떤 경로가 바뀌는지 확인하는 편이 안전합니다.

직접 항목을 추가하는 방법

promptbox는 Astro 5 + Tailwind 3 + MDX 위에 Content Collections로 만들어졌습니다. 항목 하나가 마크다운 파일 하나입니다.

해당 카테고리 폴더에 .md 파일을 추가하고 프런트매터를 스키마에 맞춥니다.

---
title: 항목 제목
summary: 한 줄 요약 (카드와 메타 설명에 노출)
summary_en: One-line English summary
tags: [tag1, tag2]
source: https://github.com/...     # 선택: 원본 링크
license: MIT                       # 선택
order: 10                          # 낮을수록 위로
trigger: "..."                     # skills 전용
install: "..."                     # skills·tools 전용
---

카테고리마다 확장 필드가 다릅니다. 스킬은 trigger와 install, MCP는 server_name과 transport, 훅은 event와 matcher, 설정은 target_file과 tools를 씁니다. 본문에는 큐레이션된 설명과 함께 코드 블록으로 복사용 원문을 넣습니다.

로컬 실행과 빌드는 표준적인 Astro 흐름입니다.

npm install
npm run dev      # http://localhost:4321/promptbox
npm run build    # dist/에 정적 사이트 생성
npm run preview  # 빌드 결과 확인

배포 경로를 바꾸려면 환경 변수로 덮어씁니다.

SITE_URL=https://example.com BASE_PATH=/my-base npm run build

Windows에서 Git Bash를 쓴다면 함정이 하나 있습니다. MSYS가 /my-base 같은 값을 윈도우 경로로 바꿔 링크가 깨집니다. MSYS_NO_PATHCONV=1을 앞에 붙이거나 PowerShell을 쓰면 해결됩니다. GitHub Actions의 리눅스 러너에서는 이 문제가 없습니다.

사본이 원본과 어긋나는 문제를 막는 장치

카탈로그 사이트의 가장 큰 약점은 복사해 둔 원문이 낡는 것입니다. promptbox는 프런트매터에 mirror_of 필드로 원본 파일의 raw URL을 적고, 검증 스크립트로 확인합니다.

npm run check:mirrors   # 복사본이 원본에서 벗어나면 실패
npm run check:prompt    # 온보딩 설치 프롬프트 검사
npm run check           # 두 검사를 함께 실행

이 장치가 있다고 해서 항상 최신이 보장되지는 않습니다. 검사를 돌려야 어긋남이 드러나고, mirror_of가 없는 항목은 대상에서 빠집니다. 그래도 "복사본이 조용히 낡는다"는 카탈로그의 구조적 약점을 인식하고 만든 안전장치라는 점은 분명합니다.

배포와 라이선스에서 확인할 점

배포는 main에 푸시할 때마다 GitHub Actions가 처리합니다. Node 22로 npm ci를 돌리고, 저장소 이름을 기준으로 base와 site를 자동 계산한 뒤 dist/를 Pages 아티팩트로 올립니다. <owner>/<owner>.github.io 형태면 base=/, 그 외에는 base=/<repo-name>이 됩니다. 포크해서 쓰려면 저장소 설정에서 Pages의 Source를 GitHub Actions로 바꿔야 첫 빌드가 게시됩니다.

도입 전에 확인할 점도 있습니다.

• 저장소 라이선스 파일이 없습니다. README는 사이트 셸 코드가 MIT라고 밝히지만, GitHub API가 반환하는 라이선스 정보는 비어 있습니다. 항목별 라이선스는 프런트매터의 license 필드나 source 링크를 따릅니다. 회사 환경에 도입한다면 개별 항목의 원본 라이선스를 직접 확인해야 합니다.
• 개인 큐레이션 프로젝트입니다. 2026년 5월 25일 생성됐고 스타 수는 아직 0입니다. 기업이 유지하는 표준 레지스트리가 아니라 한 사람이 모으는 모음집으로 읽는 편이 정확합니다.
• 품질 판단은 결국 사용자 몫입니다. 원문 복사 방식은 편하지만, 붙여 넣는 순간 그 프롬프트는 내 에이전트의 권한으로 실행됩니다. 파일을 지우거나 명령을 실행하는 스킬은 내용을 읽고 넣어야 합니다.

프롬프트 자체를 다듬는 기준이 필요하다면 프롬프트 엔지니어링 실전 가이드가 복사한 템플릿을 내 작업에 맞게 고치는 데 도움이 됩니다.

누구에게 맞을까

promptbox는 다음 상황에 특히 잘 맞습니다.

• Claude Code나 Codex를 막 시작해서 무엇부터 설치할지 모를 때
• 여러 에이전트를 함께 쓰면서 설정이 도구마다 흩어져 있을 때
• 스킬이나 훅을 만들어 보기 전에 잘 만든 예시를 읽고 싶을 때

반대로 팀 전체가 쓰는 표준 도구 레지스트리, 버전 고정, 보안 감사 같은 요구가 있다면 이 저장소만으로는 부족합니다. 그때는 promptbox에서 고른 항목을 사내 저장소로 옮기고 버전과 검토 기록을 따로 관리하는 편이 낫습니다.

가장 현실적인 시작 방법은 이렇습니다. 먼저 사이트를 열어 스킬 카테고리를 훑고, 지금 겪는 문제와 직접 맞닿은 항목 하나를 고릅니다. 원문을 복사해 ~/.claude/skills/<이름>/SKILL.md에 넣고 실제 작업에서 한 번 발동시켜 봅니다. 그 한 개가 실제로 시간을 줄여 준 다음에 온보딩 프롬프트로 묶음 설치를 검토해도 늦지 않습니다.

참고자료

• cskwork/promptbox GitHub 저장소
• promptbox 공개 사이트
• promptbox 콘텐츠 스키마 (src/content/config.ts)
• promptbox 2026-08-15 변경 기록
• Astro Content Collections 공식 문서