Prompt Writer Skill

거친 요구사항을 AI가 바로 이해하고 실행할 수 있는 구체적인 프롬프트로 바꿔주는 Codex 스킬 패키지입니다.

이 스킬은 사용자의 목표, 대상 AI, 제약 조건, 예시, 공식 프롬프팅 가이드, 원하는 출력 형식을 분석한 뒤 바로 사용할 수 있는 프롬프트를 작성하도록 설계되어 있습니다.

주요 기능

• 요구사항을 역할, 작업, 맥락, 제약, 출력 형식, 품질 기준으로 구조화
• ChatGPT, OpenAI API, Claude, 코딩 에이전트, 리서치 에이전트, 이미지/비디오 모델용 프롬프트 분류
• OpenAI와 Claude 공식 프롬프팅 가이드를 반영한 프롬프트 작성
• 복잡한 요청에서는 여러 프롬프트 방식 중 적합한 선택지를 제안
• npm 패키지와 Codex 플러그인 형태로 배포할 수 있는 구조 제공

구성

• skills/prompt-writer/SKILL.md: 스킬의 메인 동작 지침
• skills/prompt-writer/references/official-prompting-playbook.md: OpenAI와 Claude 공식 문서를 분석한 프롬프팅 플레이북
• skills/prompt-writer/references/ai-notes-patterns.md: swyxio/ai-notes에서 선별한 실전 프롬프팅 패턴
• .codex-plugin/plugin.json: Codex 플러그인 메타데이터
• package.json: npm 패키지 메타데이터와 검증 스크립트
• scripts/validate-package.mjs: 패키지 구조 검증 스크립트

설치

npm install prompt-writer-skill

설치 후 postinstall 스크립트가 스킬 파일을 사용자 스킬 디렉터리로 복사합니다.

• Codex: ${CODEX_HOME:-~/.codex}/skills/prompt-writer
• Claude Code: ${CLAUDE_CONFIG_DIR:-~/.claude}/skills/prompt-writer

이미 설치된 패키지에서 스킬만 다시 복사하려면 아래 명령을 실행합니다.

npx prompt-writer-skill

설치 스크립트를 실행하지 않고 패키지만 설치해야 하는 환경에서는 아래처럼 건너뛸 수 있습니다.

PROMPT_WRITER_SKILL_SKIP_INSTALL=1 npm install prompt-writer-skill

설치 후 Codex 또는 Claude Code를 재시작하면 prompt-writer 스킬을 사용할 수 있습니다.

로컬에서 바로 확인하려면 이 저장소를 클론한 뒤 패키지 내용을 검증합니다.

git clone https://github.com/Songgyubin/prompt-writer-skill.git
cd prompt-writer-skill
npm run validate

사용법

Codex에서는 $prompt-writer, Claude Code에서는 /prompt-writer를 호출하고, 만들고 싶은 프롬프트의 목적과 대상 AI를 함께 적습니다.

이 스킬은 자동 참조용이 아니라 사용자가 $prompt-writer 또는 /prompt-writer를 명시한 요청에서만 사용되도록 설정되어 있습니다.

$prompt-writer
신규 SaaS 랜딩페이지 카피를 만들 프롬프트를 작성해줘.
대상 AI는 ChatGPT이고, 결과는 한국어로 받고 싶어.

$prompt-writer
이 저장소의 버그를 고치라고 Codex에게 시킬 프롬프트를 만들어줘.
요구사항: 원인 분석, 최소 수정, 테스트 실행, 변경 파일 요약 포함.

$prompt-writer
Claude용 리서치 프롬프트로 다듬어줘.
주제: B2B 고객 온보딩 체크리스트
조건: 근거 중심, 섹션별 출력, 불확실한 내용은 명시.

더 좋은 결과를 얻으려면 아래 정보를 함께 제공합니다.

• 대상 AI 또는 실행 환경: ChatGPT, OpenAI API, Claude, Codex, 이미지 모델 등
• 작업 목표: 작성, 리팩터링, 리서치, 분석, 이미지 생성 등
• 입력 자료: 요구사항, 참고 문서, 기존 프롬프트, 예시 출력
• 제약 조건: 언어, 톤, 길이, 금지 사항, 출력 형식
• 성공 기준: 반드시 포함해야 할 항목이나 검증 방법

반영된 프롬프팅 원칙

이 스킬은 OpenAI와 Claude 공식 가이드에 더해 swyxio/ai-notes의 실전 노트를 참고합니다. 특히 구조화 출력의 unknown/unsure 처리, 재사용 프롬프트의 eval 사례, 검색/RAG 프롬프트의 prompt-injection 방어, 코딩 에이전트의 검증 지시, 이미지 프롬프트의 negative prompt와 모델 파라미터를 반영합니다.

검증

npm run validate
npm run pack:dry-run

npm run validate는 필수 파일, 패키지명과 플러그인명 일치 여부, 스킬 frontmatter, TODO placeholder 잔존 여부를 확인합니다.

npm run pack:dry-run은 npm 배포 시 포함될 파일 구성을 미리 확인합니다.

배포

수동 배포가 필요할 때는 검증 후 npm에 publish합니다.

npm run validate
npm run pack:dry-run
npm publish

main 브랜치에 push되면 GitHub Actions가 패키지를 검증한 뒤 npm에 publish합니다.

자동 배포는 npm Trusted Publishing을 사용합니다. 장기 publish token이나 NPM_TOKEN GitHub secret은 쓰지 않습니다.

최초 1회 설정:

npx [email protected] trust github prompt-writer-skill \
  --repo Songgyubin/prompt-writer-skill \
  --file npm-publish.yml

npm 계정 2FA가 켜져 있어야 trusted publisher 등록이 가능합니다. trusted publisher 등록과 첫 배포 확인 후 npm 패키지 Settings > Publishing access에서 Require two-factor authentication and disallow tokens를 선택합니다.

npm은 이미 배포된 같은 버전의 재배포를 허용하지 않습니다. 배포가 필요한 변경은 package.json과 .codex-plugin/plugin.json의 version을 함께 올린 뒤 main에 반영해야 합니다. 워크플로는 현재 버전이 이미 npm에 있으면 publish를 건너뜁니다.