Akm Eval — Development skill for Claude Code

AKM Eval — 에이전트 지식관리 셀프 평가 스킬

**AKM Index v1.2**로 "내 지식관리 시스템이 AI 에이전트와 함께 얼마나 성숙하게 굴러가는가"를 0–100점으로 측정하는 Claude Code 스킬. 공식 사이트: **https://akm.cmdspace.work** · 참여 안내: **https://akm.cmdspace.work/submit.html**

[](https://akm.cmdspace.work) [](LICENSE)

무엇을 측정하나

노트 정리 실력이 아니라 **시스템 전체** — 사람 + 지식 저장소 + 에이전트 런타임 + 운영 루프 — 를 측정합니다. 아름다운 제텔카스텐도 에이전트가 접근 못 하면 낮은 점수를, 노트가 거칠어도 에이전트 파이프라인이 견고하면 높은 점수를 받습니다.

필러	핵심 질문	가중치
P Prompt Engineering	에이전트에게 주는 지시가 버전 관리되는 자산인가?	20%
C Context Engineering	맞는 지식을 적정 분량으로 찾을 수 있는가?	25%
H Harness Engineering	도구·권한·메모리·오케스트레이션이 정비됐는가?	20%
L Loop Engineering	사이클이 실제로 돌고 복리로 쌓이는가? (30일 가동 증거 필수)	20%
X Interop & Governance	여러 런타임에서 이식되고, 복구·보안이 담보되는가?	15%

• 필러당 5개 기준 × 레벨 0–4 (부재 → 임시 → 문서화 → 시스템화 → 자가개선) = 25개 기준, 100점 만점
• 밴드: 0–20 M0 수동 · 21–40 M1 도구화 · 41–60 M2 체계화 · 61–80 M3 오케스트레이션 · 81–100 M4 복리형
• 모든 점수는 증거(파일 경로·설정·날짜 있는 로그)를 요구합니다. 자기보고만으로는 상한 1점, 레벨 4는 "시스템이 시스템을 고친 기록" 없이는 불가.

무엇을 받게 되나

1. 토익 성적표식 평가 리포트 — 총점·밴드, 필러별 점수+정성 코멘트, 25기준 히트맵, 환경·에이전트 사용 지표, 강점 3 / 개선 로드맵(예상 상승폭 순), 가이드 문구
2. (제출 시) 로컬 성적표 HTML (akm-report.html) — 공식 성적표와 동일한 포맷, 브라우저로 열면 끝(서버 불필요). 파일 하나로 친구에게 공유할 수 있고, 받은 사람도 하단 링크에서 바로 자기 평가를 시작할 수 있습니다. 보드 공개를 원치 않아도 제출만 하면 발급됩니다. Claude Code처럼 Artifact를 지원하는 런타임에서는 같은 성적표가 비공개 웹페이지(Artifact)로도 즉시 게시되어 링크로 볼 수 있습니다.
3. (제출 + 보드 공개 동의 시) 공개 평가 보드 카드 — https://akm.cmdspace.work/#board — 와 개인 성적표 URL

캘리브레이션 기준 사례(제작자 본인 시스템, 72.0/M3): https://akm.cmdspace.work/report.html?id=cmds-2026-07

요구사항

• Claude Code (권장 — 다른 코딩 에이전트도 SKILL.md를 지침서로 읽고 수동 실행 가능)
• 지속적으로 쓰는 지식 저장소 (Obsidian, Notion 내보내기, 마크다운 레포, 위키 등 형식 무관)
• 최근 30일 내 에이전트 사용 흔적

설치

# 방법 1 — git clone (권장, 업데이트 쉬움)
git clone https://github.com/johnfkoo951/akm-eva