Communitygithub.com

newkayak12/포트폴리오 글쓰기 패턴 분석기

포트폴리오 내용이 아니라 '어떻게 읽히는지' 분석: 피동형 비율, 주어 감사, 숫자 밀도, 의사결정 가시성 등. '패턴 분석해줘', '오너십이 잘 드러나나', '피동형 많이 썼나'에 반응합니다.

포트폴리오 글쓰기 패턴 분석기란 무엇인가요?

이 스킬은 개발자 포트폴리오의 글쓰기 패턴을 분석하는 전문 도구입니다. 내용 자체가 아니라 '어떻게 읽히는지'에 초점을 맞추며, 6가지 차원(주어 감사, 행위주체 언어, 숫자 밀도, 실패 서사, 의사결정 가시성, 동사 에너지)을 체계적으로 평가합니다. 각 차원마다 비율을 계산하고, 경계값 규칙을 적용하여 플래그를 결정합니다. 경계값 규칙에 따르면, 기준이 ~20%인 의사결정 동사 비율이나 ~60%인 숫자 없는 영향 주장 비율은 잠정적 기준이며, 실제 값이 기준보다 10%포인트 이상 차이 나고 단일 항목 이동으로 기준 안으로 들어오지 않을 때만 플래그를 발생시킵니다. 그 외에는 '경계 (값, 기준 ~N%)' 형식으로 표시합니다. 한국어 포트폴리오를 완전히 지원하며, Claude Code와 같은 환경에서 sequentialthinking과 think 도구를 사용해 분석을 수행합니다. 출력은 신호 요약, 항목별 분석, 상위 3개 패턴, 패턴별 개선 제안으로 구성되며, 개선 제안 시 사실이 부족한 부분은 `[확인 필요: ○○]`로 표시하여 역산이나 가상의 수치를 절대 제공하지 않습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/newkayak12/claude-skills/tree/HEAD/portfolio/skills/pattern

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

포트폴리오 글쓰기 패턴 분석기은(는) 무엇을 하나요?

상시 지침

  • 항상 판단을 먼저 제시하라. 한 줄 요약 평결과 가장 중요한 발견이 먼저 오고, 차원별 집계, 상위 3개 패턴 및 수정 사항이 뒤따른다.
  • 항상 집계하라, 형용사로 평가하지 마라. 모든 비율 뒤에는 번호가 매겨진 문장 목록이 작업 내에 있어야 한다 — 집계할 수 없는 비율은 보고하지 않는다.
  • 절대 사실을 추가하지 마라. 수정 사항은 어디를 어떤 형태로 바꿔야 하는지 보여준다. 숫자, 대안, 원인 또는 맥락이 본문에 없으면 [확인 필요: ○○]를 쓰고 멈춘다. 역산이나 후보 값을 절대 제시하지 않는다. "API 응답속도 개선"은 "[확인 필요: 개선 전/후 수치]"를 붙이고 "40% 개선"이라고 쓰지 않는다.
  • 절대 경계값에서 플래그를 발생시키지 마라. 의사결정 동사 ~20% 및 숫자 없는 주장 60% 기준은 잠정적이다: 평가 픽스처에서 설정된 값이며, 선별 연구 결과가 아니며, 업계 수치로 제시되지 않는다. 플래그는 값이 기준보다 최소 10포인트 이상 차이 나고 그리고 하나의 항목을 이동해도 기준 이내로 돌아오지 않을 때만 발생한다. 그 외의 경우 집계 줄은 경계 (58%, 기준 ~60%) — 일반적으로 경계 (값, 기준 ~N%) — 로 표시하고 플래그를 올리지 않는다.
  • 저는/제가 사용 빈도를 절대 측정하지 마라 (주어 감사 항목 참조).

대상이 아닌 경우: 약한 부분 다시 쓰기(rewrite), 전반적인 품질 평가(feedback), JD 키워드 매칭(fit).

입력: 포트폴리오 텍스트 (붙여넣기 또는 업로드); 한국어 완전 지원.

프로세스

  1. 차원 매핑 — 주어 감사, 행위주체 언어, 숫자 밀도, 실패 서사, 의사결정 가시성, 동사 에너지.
  2. 패턴 탐지 — 각 차원 집계; 각 차원 전에 think 도구 사용, 소유권이 논쟁되는 경우 mcp-reasoner 사용.
  3. 비율 계산 — 의사결정 동사 비율, 피동형 비율, 숫자 없는 영향 주장 비율; 플래그 전에 경계값 규칙 적용.
  4. 상위 3개 패턴 식별 — 인상에 가장 해를 끼치거나(또는 도움이 되는) 패턴, 각각 인용 예시 포함.
  5. 패턴별 수정 사항 생성 — 정확히 어느 문장을 어떤 형태로 바꿀지, 사실은 [확인 필요: ○○]로 남김.

1단계 — 패턴 매핑 (순차적 사고)

자세히 읽기 전에 sequentialthinking을 호출하여 계획을 세운다: 어떤 차원이 오너십과 시니어리티를 나타내는지; 한국어 기술 글쓰기에서 피동형으로 간주되는 것(되었습니다, 팀 주어와 함께 구현했습니다)이 무엇인지; 일화가 아닌 체계적으로 집계하는 방법.

2단계 — 패턴 탐지 (Think 도구 — 각 차원 필수)

6개 차원 각각을 분석하기 전에 think를 호출한다 — 모호한 경우에만 호출하는 것이 아니다:

think: "이 차원이 지원자가 강한 오너십을 가졌다면 어떻게 보일까?
이 포트폴리오는 실제로 무엇을 보여주는가?
실제 패턴을 보고 있는가, 아니면 하나의 눈에 띄는 예시를 보고 있는가?
비율이 경계값인가?"

한 구절에 경쟁하는 소유권 신호가 있을 때 mcp-reasoner(beam_search, beamWidth=3)를 호출한다:

  • Beam A: 개인 오너십 — 지원자가 분명히 의사결정자이자 행위자임
  • Beam B: 팀 크레딧 — 협업 작업에 대한 적절한 인정
  • Beam C: 소유권 회피 — 개인 기여가 약함을 모호하게 하기 위해 집합적 언어 사용

이것은 주어 감사와 행위주체 언어에 가장 중요하다.

🧠 패턴 노트: 명확하지 않은 판단은 인라인으로 기록한다 — 특히 mcp-reasoner가 분류를 변경한 경우.

분석할 차원

1. 주어 감사. 각 문장에서 누가 행위를 하는가:

  • "저희 팀이 / 팀에서" — 개인 기여가 불분명한 팀 크레딧 (지배적일 때 플래그)
  • 주어 없음, 능동 — "제안했습니다", "채택했습니다" (한국어에서 정상; 결함 아님)
  • 주어 없음, 피동 — "구현되었습니다", "도입되었습니다" (플래그)

저는/제가 사용 빈도를 측정하지 마라. 주어 생략은 국문 경력기술서에서 표준이며, 잘 쓰인 문서는 0%에 가깝다 — 대명사 임계값은 오히려 오너십이 강한 문서에 플래그를 꽂는 잘못된 결과를 낳는다. 소유자와 실행자를 가르는 것은 동사이다: 의사결정 동사(제안 / 채택 / 배제 / 결정 / 도입 판단)를 포함하는 행위 문장을 세고 그 비율을 보고한다. ~20% 미만(잠정; 경계값 규칙 적용)이 명확히 신호이다 — 지원자는 시킨 대로 만들었을 뿐 누가 선택했는지는 말하지 않는다.

2. 행위주체 언어. 지원자가 행위의 대상이 되는 문장을 플래그:

  • 피동형: ~되었습니다, ~되었고, ~되어
  • 모호한 참여: "관여했습니다", "참여했습니다", "기여했습니다" (무엇을 했는지 구체적으로 말하지 않음)
  • 지시된 업무: "맡았습니다" — 왜 선택되었는지, 무엇을 결정했는지 없이

3. 숫자 밀도. 얼마나 많은 영향 주장이 구체적인 숫자를 동반하는가:

  • 숫자 있음: "응답시간 40% 감소", "MAU 12만 → 80만"
  • 숫자 없음: "성능 개선", "대용량 트래픽 처리", "안정적인 서비스 운영"

비율을 보고한다. 5년차 이상 포트폴리오의 경우 숫자 없는 비율이 60%를 명확히 초과(잠정; 경계값 규칙 적용)하면 문제이다.

4. 실패 서사. 장애와 대처, 잘못된 결정과 회복, 인정된 기술 부채, 명시된 트레이드오프를 스캔한다. 여러 해에 걸쳐 완전히 부재하는 것 자체가 신호이다 — 자기 성찰적이지 않거나, 회피적이다.

5. 의사결정 가시성. 선택이 이루어지는 것을 볼 수 있는가? "A 대신 B를 선택한 이유는...", "당시 옵션은 X, Y, Z였고 Y를 선택했는데...", "돌아보면 이 결정이 좋지 않았던 이유는...". 모든 기술 선택이 당연하거나 사전 결정된 것처럼 제시되는 것은 플래그할 가치가 있는 패턴이다.

6. 동사 시제와 에너지. 상태 보고서처럼 읽히는지 이야기처럼 읽히는지, 동사가 구체적인지("설계했다", "디버깅했다", "제안했다") 일반적인지("했습니다", "진행했습니다") 기록한다.

출력 템플릿

분석 결과를 한국어로 작성한다:


[시그널 요약] 한 줄: 이 글쓰기 패턴이 면접관에게 내용을 읽기 전에 무엇을 알려주는지. 그 다음 가장 중요한 발견 하나와 그 집계.


[항목별 분석]

  • 의사결정 동사 비율: [n/m = n% — 플래그, 또는 경계 (값, 기준 ~20%)]
  • 수동/피동 표현: [개수, 예시]
  • 숫자 밀도: [숫자 없음 n/m = n% — 플래그, 또는 경계 (값, 기준 ~60%)]
  • 실패/어려움 서술: [있음 / 미미함 / 없음 — 예시]
  • 의사결정 가시성: [드러난 결정 대 암시된 결정]
  • 동사 에너지: [평평함 / 보통 / 활발함 — 예시]

🧠 Pattern note는 명확하지 않은 판단이 필요한 발견이 있을 때 삽입한다.


[가장 자주 나타나는 패턴 Top 3] 인상에 가장 해를 끼치거나(또는 도움이 되는) 세 가지 패턴, 각각 본문에서 인용된 예시 포함.


[패턴별 개선 제안] 플래그된 각 패턴에 대해: 형태를 바꾸는 구체적인 수정 하나, 절대 사실을 추가하지 않음. "능동태를 더 사용하세요"가 아니라 "'팀에서 Kafka를 도입했습니다'를 '[확인 필요: 검토한 대안]을 비교해 Kafka를 채택했습니다'로 바꿔, 누가 무엇을 근거로 정했는지 드러내세요."

Claude의 역할 / 사용자의 역할

Claude사용자
6개 차원 감사: 주어 감사, 행위주체 언어, 숫자 밀도, 실패 서사, 의사결정 가시성, 동사 에너지포트폴리오 텍스트 제공
비율 계산 및 경계값을 플래그 대신 경계로 표시실제 의도에 따라 결과 검증
상위 3개 패턴을 인용과 각각 하나의 수정 사항으로 식별, 부족한 사실은 [확인 필요]로 표시[확인 필요] 사실을 채우고 다시 쓸 내용 결정 (또는 rewrite 사용)

관련 스킬

  • ../rewrite/SKILL.md — 여기서 식별된 패턴에 따라 수정 실행
  • ../feedback/SKILL.md — 패턴 분석과 함께 전반적인 평가
  • ../fit/SKILL.md — 패턴 개선 후 특정 JD와의 적합성 확인

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

newkayak12/claude-skills

>- Use when a PPTX must be built from content instead of typed slide by slide — read a template, write the deck as markdown, render. Triggers: PPT 만들어줘, 템플릿에 내용 채워줘, 발표자료 생성, md로 PPT 만들기, deck from markdown, PPT 키컬러 변경, 브랜드 컬러로 교체, recolor pptx.

newkayak12/claude-skills

>- Use when someone explicitly asks for beta portfolio feedback: feedback plus writing patterns (피동, team subject, number density, decision visibility). Triggers only on "피드백 베타로", "feedback beta".

newkayak12/claude-skills

>- Use when someone shares a developer portfolio and wants interviewer-grade feedback: screen verdict, whether numbers and skills hold up, whether it reads at the claimed level. Triggers: "포트폴리오 피드백 해줘", "서류 통과할까", "숫자 근거 있어?", "시니어로 읽혀?", "고친 버전 비교".

newkayak12/claude-skills

>- Use when judging a portfolio's fit to a JD, or with no JD to company types or a named company. Triggers: "이 공고에 맞아?", "JD랑 비교해줘", "어느 회사에 잘 맞아?", "네이버 지원하려는데 어때?", "which companies fit me". Not generic "서류 통과할까?" (feedback).

newkayak12/claude-skills

>- Use when someone needs an interview preparation plan before their interview process begins — a study schedule, gap analysis by topic area, and STAR story prompts. This is planning, not practice. Triggers on: "interview prep plan", "면접 준비 계획".

newkayak12/claude-skills

>- Use when preparing a job application or career transition end-to-end, from JD fit through 자기소개서 to mock interview. Triggers on: "job application workflow", "이직 준비 전체", "취업 프로세스 시작", "career transition", "job search process".

newkayak12/claude-skills

>- Use when someone wants a realistic mock interview grounded in their own portfolio, with per-answer coaching. Triggers on: "모의 면접 해줘", "인터뷰 연습", "mock interview", "grill me on my portfolio".

newkayak12/claude-skills

>- Use when resume or portfolio lines need a stronger rewrite, optionally to a JD. Triggers: "이 문장 고쳐줘", "이 부분 어떻게 쓰면 좋아", "더 잘 쓰는 법", "임팩트 있게 바꿔줘", "rewrite this portfolio section", "이력서 맞춰줘", "공고에 맞게 고쳐줘", "이력서 최적화", "tailor my resume to this JD".

관련 스킬