Promptbox — Coleção de Prompts & MCP
cskwork/promptbox
Colecione, organize e copie prompts/skills/MCPs em um único lugar
Ver no GitHubSite estático (Astro + Tailwind) que reúne prompts, skills, configurações de agentes e MCP servers em uma UI de cards/sidebar com busca e cópia com um clique. Ideal para organizar e reutilizar rapidamente templates de IA em GitHub Pages.
Instalação
npx convez-ai cskwork/promptbox1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Manter biblioteca pessoal de prompts reutilizáveis
- Compartilhar configurações de agentes e MCP entre equipe
- Hospedar templates de skills (Code, Codex, Hermes) em um repositório centralizado
Veredito

Solução prática e leve para curar prompts/skills/MCPs com deploy automático via GitHub Pages. Bem estruturada em Astro/Tailwind, mas requer git e npm — ideal para times que já usam GitHub Actions.
README
A tradução para o português deste README ainda está na fila.
prompt-collection
자주 쓰는 프롬프트·스킬·MCP 설정을 한 곳에 모아놓고 GitHub Pages에서 카드/사이드바 UI로 바로 복사해서 쓰는 컬렉션 사이트.
- 스택: Astro 5 + Tailwind 3 + MDX + Content Collections
- 출력: 정적 사이트,
dist/→ GitHub Pages - 콘텐츠:
src/content/{prompts,skills,configs,mcps}/*.md
카테고리
| 폴더 | 용도 | 예 |
|---|---|---|
prompts/ | 그대로 복사해 쓰는 프롬프트 템플릿 | transcription-cleanup |
skills/ | Claude Code · Codex · Hermes용 SKILL.md | clone-personalize, stitch-landing |
configs/ | CLAUDE.md, AGENTS.md 같은 에이전트 시스템 프롬프트 | Ten Commandments |
mcps/ | MCP 서버 설정 스니펫 | (추가 예정) |
로컬 실행
npm install
npm run dev
# http://localhost:4321/promptbox
빌드
npm run build # dist/에 정적 사이트 생성
npm run preview # 빌드 결과 미리보기
기본 site/base는 환경 변수로 덮어쓸 수 있다:
SITE_URL=https://example.com BASE_PATH=/my-base npm run build
Windows + Git Bash 사용자 주의: MSYS가
/my-base같은 환경변수를 Windows 경로로 변환해 링크가/C:/Program Files/Git/my-base/로 깨진다. 다음 둘 중 하나로 해결:MSYS_NO_PATHCONV=1 BASE_PATH=/promptbox npm run build # 또는 PowerShell 사용 $env:BASE_PATH = "/promptbox"; npm run buildGitHub Actions(Linux)에서는 이 문제가 없다.
항목 추가하는 법
- 해당 카테고리 폴더에
.md또는.mdx파일 추가 - frontmatter는
src/content/config.ts스키마를 따른다:
---
title: 항목 제목
summary: 한 줄 요약 (카드/메타 설명에 노출)
tags: [tag1, tag2]
source: https://github.com/... # 선택: 원본 링크
author: cskwork # 선택
license: MIT # 선택
order: 10 # 정렬 우선순위 (낮을수록 위)
# 카테고리별 확장 필드
trigger: "..." # skills 전용
install: "..." # skills 전용
target_file: "..." # configs 전용
tools: [Claude Code] # configs 전용
use_case: "..." # prompts 전용
---
- 본문에는 큐레이션된 설명 +
```코드블록으로 복사용 원문을 함께 둔다. 상세 페이지의 "원문 복사" 버튼은 frontmatter를 제외한 본문 전체(entry.body)를 클립보드에 복사한다.
GitHub Pages 배포
.github/workflows/deploy.yml이 main 푸시마다 자동으로:
- Node 22 +
npm ci - 저장소 이름을 기준으로
base/site자동 계산<owner>/<owner>.github.io형태 →base=/- 그 외 →
base=/<repo-name>
npm run builddist/를 Pages 아티팩트로 업로드 →deploy-pages@v4로 게시
리포지토리 Settings → Pages → Source를 GitHub Actions로 설정해야 첫 빌드가 게시된다.
디렉토리 구조
src/
├── content/
│ ├── config.ts # Content Collections 스키마
│ ├── prompts/*.md
│ ├── skills/*.md
│ ├── configs/*.md
│ └── mcps/*.md
├── components/
│ ├── Header.astro # 상단 nav + 테마 토글
│ ├── Sidebar.astro # 좌측 카테고리 네비 + 검색
│ └── CopyButton.astro
├── layouts/
│ └── BaseLayout.astro
├── pages/
│ ├── index.astro # 카드 그리드 홈
│ ├── [category]/[...slug].astro # 상세 페이지
│ └── 404.astro
└── styles/
└── global.css # Tailwind + 커스텀 prose
라이선스
각 콘텐츠 항목의 라이선스는 frontmatter license 필드 또는 source 링크를 따른다. 사이트 셸 코드 자체는 MIT.