jasoseo — 자기소개서 작성 파이프라인 (Claude Code 플러그인)

회사 하나 조사하고, 문항 뜯어보고, 초안 쓰고, 글자 수 맞추고, 검토하고, 다듬고, 다시 확인하고… 자소서 한 편에 드는 이 반복을 8단계로 정리해 자동으로 돌려주는 Claude Code 플러그인입니다. 특히 여러 회사에 동시에 지원하는 신입·인턴 지원자를 위해 만들었습니다.

이 플러그인이 대신 해주는 일

여러 회사에 지원하다 보면 매번 똑같은 실수가 반복됩니다. jasoseo는 그걸 막아줍니다.

• 소재 중복 — 같은 프로젝트·같은 수치를 이 문항 저 문항에 또 쓰는 걸 자동으로 잡아냅니다 (같은 숫자가 두 번 나오면 "소재가 부족한 사람"으로 읽힙니다).
• 경험 과장·거짓 — 이력서에 없는 성과, 팀 프로젝트에서 내가 안 한 부분을 "내가 했다"고 쓰는 걸 사실 대조로 걸러냅니다.
• 글자 수 미달/초과 — 문항마다 Python으로 실측해서 제한의 95%를 정확히 채웁니다.
• 회사별 파일 정리 — 회사마다 폴더를 만들고, 폴더 이름에 마감일을 붙여 뭐가 급한지 한눈에 보이게 합니다.

대신, 못 하는 것도 분명히 말씀드립니다: 실제 지원 폼에 자동 제출은 하지 않습니다(최종 검토·제출은 본인 몫). 그리고 글자 수 기준이 "공백 포함이냐 제외냐"는 공고에 안 적힌 경우가 많아, 제출 전 지원 폼에서 한 번 확인하시라고 항상 안내합니다.

시작하기 전에

• Claude Code가 설치되어 있어야 합니다. (설치 안내)
• 본인 이력서를 텍스트로 정리해 둔 파일이 필요합니다 (아래에서 설명).

설치 (3분)

1단계 — 플러그인 설치

GitHub에서 설치 (권장):

/plugin marketplace add KangRyun/jasoseo-plugin
/plugin install jasoseo@jasoseo-marketplace

직접 클론해서 로컬로 써보려면 (내려받은 폴더 경로를 그대로 사용):

/plugin marketplace add ./jasoseo-plugin
/plugin install jasoseo@jasoseo-marketplace

2단계 — 작업 폴더 준비

지원 준비를 모아둘 폴더(예: ~/취업준비)를 하나 만들고, 그 안에서 Claude Code를 실행합니다. 이 폴더에 아래 두 파일을 둡니다.

파일	필수?	무엇을 담나
이력서.md	필수	학력·경력·프로젝트·수상·스킬 등 사실. 자소서의 모든 소재는 여기서만 가져옵니다. 여기 없는 건 자소서에 안 씁니다.
PROFILE.md	선택(권장)	이력서엔 안 적었지만 자소서엔 쓸 수 있는 것 — 예: "이 프로젝트의 A기능은 팀원이 한 거라 내 성과로 쓰면 안 됨", "여러 회사에 반복해서 쓸 나만의 핵심 컨셉" 등.

이력서.md가 어떤 모습이어야 할지 감이 안 오면, 그냥 이력서 내용을 마크다운으로 편하게 적어두면 됩니다(항목별 제목 + 내용). PROFILE.md는 템플릿을 복사해 채우세요 — 비워둬도 동작하고, 진행하면서 알게 된 사실이 계속 쌓입니다.

사용법

작업 폴더에서 Claude Code를 켜고, 회사명과 직무를 함께 입력합니다:

/jasoseo 삼성전자 데이터엔지니어

회사명과 직무는 둘 다 필수입니다. 같은 회사라도 직무가 다르면(데이터엔지니어 / 반도체 공정 / 영업) 자소서가 완전히 달라지기 때문입니다. 직무 없이 회사명만 입력하면 Claude가 먼저 직무를 물어본 뒤 진행합니다. 이어서 채용 공고(링크나 이미지)·문항·마감일도 물어보고 8단계를 시작합니다.

특정 단계부터 이어가고 싶으면 맨 끝에 단계 이름을 붙입니다:

/jasoseo 삼성전자 데이터엔지니어 리뷰      # 이미 초안이 있고, 전문가 리뷰부터

Codex(OpenAI)에서 쓰기

이 플러그인의 설치 명령(/plugin ...)은 Claude Code 전용이라 Codex에선 동작하지 않습니다. 하지만 파이프라인 본체는 표준 SKILL.md라, Codex의 Skills 기능으로 그대로 옮겨 쓸 수 있습니다 (Codex도 SKILL.md + name/description frontmatter 포맷을 씁니다).

설치 — 스킬 폴더만 복사하면 됩니다.

# 전역(어디서나 사용): ~/.agents/skills/  ·  특정 저장소에서만: <repo>/.agents/skills/
git clone https://github.com/KangRyun/jasoseo-plugin.git
mkdir -p ~/.agents/skills
cp -r jasoseo-plugin/skills/jasoseo ~/.agents/skills/jasoseo

사용 — Codex를 작업 폴더(이력서.md가 있는 곳)에서 실행하고, 자연어로 부르면 됩니다:

jasoseo로 삼성전자 데이터엔지니어 자소서 초안 잡아줘

Codex에는 이 저장소의 서브에이전트(researcher·reviewer)가 등록되진 않지만, SKILL.md가 그 역할 정의(agents/*.md)를 따라 조사·리뷰 단계를 직접 수행하도록 쓰여 있어 결과는 동일하게 나옵니다. 두 역할을 Codex 서브에이전트로 따로 등록하면 더 깔끔하게 분리 실행할 수도 있습니다.

참고: Codex의 Skills/경로는 공식 문서를 따릅니다. 버전에 따라 경로가 바뀔 수 있으니, 위 ~/.agents/skills 가 안 먹으면 문서에서 현행 위치를 확인하세요.

8단계, 이렇게 진행됩니다

단계	하는 일	나오는 파일
1. 기업 조사	미션·인재상·사업·최근 실적 조사 + 내 경험과의 연결 전략	기업조사_<회사>.md
2. 공고·문항 분석	문항이 실제로 뭘 묻는지 분해 (복합 질문이면 하위 질문까지)	자기소개.md
3. 초안 작성	문항별 소제목 + 본문, 컨셉 한 줄로 관통	자기소개서_초안.md
4. 글자 수 조정	제한의 95%로 실측 + 소재 중복 자가진단	(초안 갱신)
5. 전문가 리뷰	인사담당자 관점 5축 평가(사실·직무·문항충실·차별성·표현)	리뷰_리포트.md
6. 리뷰 반영	치명 이슈 전부·권장 대부분 반영	(초안 갱신)
7. 윤문	AI 티 나는 문장을 자연스러운 한국어로 (수치·고유명사는 불변)	자기소개서_윤문.md ← 제출용 최종본
8. 최종 검증	글자 수·핵심 수치가 실제로 보존됐는지 직접 재확인	(기록 갱신)

각 회사 폴더는 <회사명>_마감0930처럼 마감일이 이름에 붙어 생성되므로, 폴더 목록만 봐도 무엇부터 써야 할지 보입니다. 마감일이 없는 상시채용은 <회사명>_수시가 됩니다.

여러 회사 한꺼번에

"이번 주에 5개 회사 마감이야" 같은 상황이면, Claude에게 여러 회사를 한 번에 맡길 수 있습니다. 회사별로 파이프라인이 병렬로 돌아가고, 각자 자기 폴더에만 파일을 쓰기 때문에 서로 안 엉킵니다. 그냥 자연어로 "이 회사들 자소서 다 써줘"라고 하고 회사 목록을 주면 됩니다.

함께 쓰면 좋은 플러그인

7단계(윤문)에서 humanize-korean 플러그인이 설치돼 있으면 자동으로 활용해 "AI가 쓴 티"를 더 잘 지웁니다. 없어도 자체 윤문으로 대체되니 필수는 아닙니다.

자주 묻는 질문

Q. 이력서가 PDF밖에 없어요. A. PDF도 읽을 수 있지만, 마크다운(이력서.md)으로 정리해두면 훨씬 정확합니다. "이 PDF를 이력서.md로 정리해줘"라고 먼저 부탁하셔도 됩니다.

Q. 없는 경력을 그럴듯하게 지어내 주나요? A. 아니요. 그게 이 플러그인의 첫 번째 원칙입니다 — 이력서에 있는 사실만 씁니다. 부족한 역량은 숨기기보다 "빠르게 배우겠다"는 식으로 정직하게 처리하도록 설계돼 있습니다.

Q. 글자 수가 공백 포함인지 제외인지 모르겠어요. A. 공고에 없으면 플러그인이 알려드리고, 제출 폼에서 직접 확인하시라고 안내합니다. 대부분 공백 포함 기준으로 맞춰두되 제출 전 확인이 필요합니다.

Q. /jasoseo가 반응을 안 해요. A. 플러그인이 활성(enabled) 상태인지 /plugin 메뉴에서 확인하세요. 같은 이름의 개인 스킬이 따로 있으면 충돌할 수 있습니다.

Q. 회사명만 넣으면 안 되나요? A. 됩니다 — 그러면 Claude가 직무를 되물어봅니다. 다만 처음부터 회사명 직무 를 같이 넣으면 한 번 덜 묻고 바로 시작합니다.

구성

jasoseo/
├── skills/jasoseo/            # 8단계 파이프라인 (오케스트레이션)
│   └── references/profile-template.md
└── agents/
    ├── jasoseo-researcher.md  # 1단계 기업 조사 전용
    └── jasoseo-reviewer.md    # 5단계 전문가 리뷰 전용

라이선스

MIT