prompts.chat을 Claude Code 플러그인으로 연결해 프롬프트 · 스킬 찾기

KAITABASE가 공식 문서와 원문을 직접 읽고 새로 쓴 가이드입니다.

이 가이드로 할 수 있는 것

prompts.chat(옛 이름 Awesome ChatGPT Prompts)은 공개 프롬프트와 에이전트 스킬을 모아 둔 사이트입니다. 저장소의 CLAUDE-PLUGIN.md 는 이 사이트를 Claude Code 안에서 바로 검색하는 공식 플러그인을 안내합니다. 플러그인을 설치하면 다음이 한꺼번에 들어옵니다.

이 가이드는 2026-10-22에 저장소를 복제해 플러그인 파일을 열어 보고, Claude Code 2.1.307의 검사 명령과 MCP 서버 요청까지 직접 해 본 결과를 옮겼습니다. 설치 자체는 사용자 설정 파일을 바꾸므로 공식 문서 기준으로 적었습니다.

빠른 시작

Claude Code 세션에서 두 줄을 차례로 입력합니다.

/plugin marketplace add f/prompts.chat
/plugin install prompts.chat@prompts.chat

공식 문서 기준(직접 실행 안 함): 첫 줄이 성공하면 Successfully added marketplace: prompts.chat 이 나옵니다. 둘째 줄은 바로 설치하지 않고 플러그인 상세 화면을 열어 설치 범위(user · project · local)를 고르게 합니다.

STEP 1. 설치 전에 플러그인 파일 들여다보기

목표: 내 컴퓨터에 무엇이 들어오는지 설치 전에 확인합니다. · 예상 시간: 3분

Claude Code 공식 문서는 플러그인이 훅과 MCP 서버를 실행할 수 있으니 설치 전에 내용을 읽으라고 안내합니다. 저장소를 얕게 복제해 파일을 봅니다.

1234git clone --depth 1 https://github.com/f/prompts.chat.git
cd prompts.chat
type .claude-plugin\marketplace.json
type plugins\claude\prompts.chat\.mcp.json

직접 확인한 .mcp.json 내용입니다. 원격 서버 하나만 연결하고, 내 컴퓨터에서 실행하는 프로그램은 없습니다.

123456{
  "prompts.chat": {
    "type": "http",
    "url": "https://prompts.chat/api/mcp"
  }
}

플러그인 폴더에는 commands/ 2개, agents/ 2개, skills/ 2개 파일과 매니페스트만 있고 hooks 는 없었습니다. 마켓플레이스와 플러그인 버전은 둘 다 1.0.0 입니다.

확인 plugins/claude/prompts.chat/ 아래 파일 목록이 CLAUDE-PLUGIN.md의 Plugin Structure와 같은지 봅니다.

막히면 저장소가 커서 복제가 오래 걸리면 GitHub 웹에서 plugins/claude/prompts.chat 폴더만 열어 봐도 됩니다.

STEP 2. 매니페스트 검사하기

목표: Claude Code가 이 플러그인을 문제없이 읽는지 설치 없이 확인합니다. · 예상 시간: 2분

claude plugin validate 는 설정을 바꾸지 않고 매니페스트만 검사합니다. 복제한 폴더에서 실행했습니다.

claude plugin validate .
claude plugin validate .\plugins\claude\prompts.chat

실제 결과(요약):

1234⚠ Found 1 warning:
  ❯ plugins[0] plugin.json → name: Plugin name "prompts.chat" is not kebab-case.
    Claude Code accepts it, but the Claude.ai marketplace sync requires kebab-case ...
✔ Validation passed with warnings

플러그인 폴더 검사에서는 아이콘이 없고(ICON_MISSING), 원격 MCP 서버에 연결하는데 개인정보 처리방침 주소가 없다는(PRIVACY_URL_MISSING) 경고가 더 나왔습니다. 둘 다 Claude Code에서 쓰는 데는 영향이 없다고 표시됐습니다.

확인 마지막 줄이 Validation passed 로 끝나면 설치할 수 있는 형식입니다.

막히면 claude plugin validate 가 없다는 오류가 나면 Claude Code가 오래된 버전입니다. claude --version 으로 버전을 보고 업데이트합니다.

STEP 3. 마켓플레이스 추가하고 설치하기

목표: 플러그인을 원하는 범위에만 설치합니다. · 예상 시간: 3분

공식 문서 기준(직접 실행 안 함):

1. 프로젝트 폴더에서 claude 를 열고 /plugin marketplace add f/prompts.chat 을 입력합니다.
2. /plugin install prompts.chat@prompts.chat 을 입력하면 상세 화면이 열립니다. Will install 목록에서 명령 · 에이전트 · 스킬 · MCP 서버를 확인합니다.
3. 범위를 고릅니다.

처음 써 본다면 local 범위를 권합니다. 셸에서 설치할 때는 claude plugin install 이 기본 user 범위이므로 --scope local 을 붙입니다.

확인 설치 요약 마지막 줄이 Plugin is now active. 면 바로 쓸 수 있고, Run /reload-plugins to apply. 면 다시 불러와야 합니다. / 를 입력했을 때 /prompts.chat:prompts 가 보이면 성공입니다.

막히면 The plugin couldn't be loaded 가 나오면 /plugin 의 Errors 탭에서 이유를 봅니다. 웹의 클라우드 세션(claude.ai/code)은 내 컴퓨터에 설치한 플러그인을 불러오지 않습니다.

되돌리기 /plugin uninstall 로 지우거나, 셸에서 claude plugin uninstall prompts.chat@prompts.chat --scope local 처럼 설치한 범위를 맞춰 지웁니다. claude plugin marketplace remove prompts.chat 은 마켓플레이스와 거기서 설치한 플러그인을 함께 지웁니다.

STEP 4. 프롬프트 · 스킬 검색하기

목표: 명령으로 검색하고 결과를 골라 씁니다. · 예상 시간: 3분

공식 문서 기준(직접 실행 안 함): CLAUDE-PLUGIN.md와 commands/prompts.md 가 안내하는 형식입니다.

1234/prompts.chat:prompts code review
/prompts.chat:prompts midjourney --type IMAGE
/prompts.chat:prompts writing assistant --category writing
/prompts.chat:skills testing automation

--type 에는 TEXT, STRUCTURED, IMAGE, VIDEO, AUDIO 를 넣습니다. 찾은 프롬프트는 /prompts.chat:prompts get <prompt-id> 로 전체 내용을 가져오고, 변수가 있으면 채우라고 묻습니다.

같은 서버에 로그인 없이 직접 검색 요청을 보내 확인한 결과, search_prompts 는 제목 · 설명 · 작성자 · 태그 · 미리보기와 함께 결과를 돌려줬습니다. 이때 받은 도구 목록은 CLAUDE-PLUGIN.md의 10개와 같았습니다.

search_prompts, get_prompt, save_prompt, improve_prompt,
search_skills, get_skill, save_skill, add_file_to_skill, update_skill_file, remove_file_from_skill

확인 결과마다 prompts.chat 링크가 붙습니다. 쓰기 전에 링크를 열어 원문 전체를 읽습니다.

주의 검색 결과는 누구나 올린 글입니다. 직접 받은 결과 중에는 설명란이 외부 판매 페이지 링크뿐인 프롬프트도 있었습니다. 투표 수 · 작성자 · 본문을 보고 고릅니다.

STEP 5. 스킬을 프로젝트에 넣을 때 확인하기

목표: 남이 만든 스킬을 내 저장소에 안전하게 들입니다. · 예상 시간: 3분

skill-lookup 스킬의 절차는 get_skill 로 파일을 받은 뒤 .claude/skills/{slug}/ 에 저장하는 것입니다. 즉 Claude가 내 저장소에 파일을 씁니다.

1. 설치를 맡기기 전에 "파일 목록과 각 파일 내용을 먼저 보여 주고, 저장은 내가 승인한 뒤에 해 주세요"라고 요청합니다.
2. 스킬 안에 스크립트(.py, .sh)가 있으면 무엇을 실행하는지 읽습니다.
3. 저장한 뒤 git diff 로 바뀐 파일을 확인하고 커밋합니다.

되돌리기 저장된 스킬 폴더 .claude/skills/<이름>/ 을 지우면 됩니다. 커밋 전이라면 git status 로 새로 생긴 파일을 확인합니다.

STEP 6. 내 프롬프트 저장하기(선택)

목표: 내 프롬프트를 prompts.chat 계정에 올립니다. · 예상 시간: 2분

공식 문서 기준(직접 실행 안 함): save_prompt · save_skill 은 API 키가 필요합니다. 키는 prompts.chat/settings에서 받고, CLAUDE-PLUGIN.md는 환경 변수 PROMPTS_API_KEY 나 MCP 헤더 PROMPTS_API_KEY 로 넘기라고 안내합니다.

주의 저장소의 .mcp.json 에는 헤더 설정이 없었습니다. 환경 변수만 정했을 때 서버로 키가 전달되는지는 이 가이드에서 확인하지 못했습니다. 저장이 안 되면 /mcp 에서 서버 연결 상태를 보고, 필요하면 헤더를 넣어 MCP 서버를 따로 등록합니다. 저장 도구에는 isPrivate 항목이 있으니 공개 여부를 꼭 정합니다.

잘못 쓰는 예 · 바르게 쓰는 예

바로 쓰는 프롬프트 · 템플릿

검색을 맡길 때:

prompts.chat에서 "PR 설명 작성" 프롬프트를 5개만 찾아 주세요.
각각 제목, 작성자, 태그, 링크를 표로 보여 주고, 본문은 아직 가져오지 마세요.

스킬을 들일 때:

search_skills로 "test automation" 스킬을 찾아 상위 3개의 파일 목록만 보여 주세요.
제가 하나를 고르면 get_skill로 전체 파일 내용을 보여 주고,
.claude/skills/ 에 저장하는 것은 제가 승인한 다음에 해 주세요.

주의할 점

• 요금: 플러그인과 검색은 무료로 공개돼 있습니다. improve_prompt 처럼 AI를 쓰는 기능의 한도 · 요금은 저장소 문서에 적혀 있지 않습니다. Claude Code 쪽 사용량은 평소처럼 차감됩니다.
• 권한: 마켓플레이스를 추가하면 Claude Code 설정 파일에 기록됩니다. 공식 문서 기준으로 제3자 마켓플레이스는 자동 업데이트가 기본으로 꺼져 있습니다.
• 보안: 검색어와 저장한 프롬프트는 외부 서버(prompts.chat)로 갑니다. 회사 코드 · 고객 정보를 검색어에 넣지 않습니다. 받은 스킬은 실행 전에 읽습니다.
• 맥락 비용: 플러그인의 스킬 · 에이전트 설명은 세션 맥락을 차지합니다. 설치 뒤 claude plugin details prompts.chat 으로 늘어난 토큰을 볼 수 있고, 안 쓰면 끕니다.
• 라이선스: 저장소 코드는 MIT, 프롬프트 데이터(prompts.csv · PROMPTS.md · 사용자 제출 프롬프트)는 CC0 1.0 퍼블릭 도메인입니다. 다만 스킬마다 따로 라이선스를 적을 수 있으니 받은 파일의 머리말을 확인합니다.

공식 자료

• CLAUDE-PLUGIN.md — https://github.com/f/prompts.chat/blob/main/CLAUDE-PLUGIN.md
• prompts.chat 저장소 — https://github.com/f/prompts.chat
• 플러그인 폴더 — https://github.com/f/prompts.chat/tree/main/plugins/claude/prompts.chat
• Claude Code 플러그인 설치 · 관리 문서 — https://code.claude.com/docs/en/discover-plugins
• Claude Code 플러그인 보안 · 신뢰 — https://code.claude.com/docs/en/plugins/security
• prompts.chat 설정(API 키) — https://prompts.chat/settings

더 보기

이 가이드는 KAITABASE가 공식 문서와 원문을 직접 읽고 실행해 본 뒤 새로 쓴 자료입니다. 같은 주제의 다른 글은 KAITABASE에서 이어서 볼 수 있습니다.

• 도구 연결 자료 모음 — https://kaitabase.vercel.app/?area=connect
• KAITABASE 전체 자료 — https://kaitabase.vercel.app