skill-align — 스킬 인벤토리·문서 정합성 감사
Lattice 저장소의 skills/ 디렉터리를 진실의 원천으로 삼아 README, docs/, PROJECT.md, CLAUDE.md, GitHub 이슈 템플릿의 문서 드리프트를 찾아 수정한다.
개발·코딩중급★ 194⑂ 13AI 점수 7/10마지막 업데이트: 2026. 9. 7.
무엇을 해주나
skills/트리를 실제로 읽어 아톰·몰레큘·리파이너의 라이브 인벤토리를 구성합니다(기억에 의존하지 않고 매번 파일에서 재수집).- README,
docs/how-it-works.md,docs/configuration.md,docs/practical-guide.md,PROJECT.md,CLAUDE.md,.github/ISSUE_TEMPLATE/*.yml을 순서대로 감사합니다. - 발견 사항을
[GAP](누락) /[STALE](사라진 것 참조) /[WRONG](관계 오류)로 분류한 리포트를 먼저 제시하고, 사용자 승인 후 파일당 1회 편집으로 일괄 수정합니다. - 가장 실수가 잦은 리파이너 → 아톰 → 몰레큘 소비 관계를 SKILL.md와 Config Resolution을 교차 확인해 검증합니다(
review-refiner만 몰레큘 직접 소비가 정상). - 마지막에 검증용
grep을 실행해 출력이 비어야 완료로 선언하며, 선택적으로./tools/install.sh로 스킬을 배포합니다.
이런 분께 추천
- Lattice 프레임워크 저장소를 직접 운영·기여하는 메인테이너.
- 스킬/플러그인 카탈로그를 문서와 이슈 템플릿에 중복 기재해야 하는 프로젝트 관리자.
- "코드는 바뀌었는데 문서가 안 바뀌는" 드리프트 감사 패턴을 자기 저장소용으로 참고하고 싶은 개발자.
활용 예시
- 새 아톰을 추가한 뒤 "align docs" 라고 말하면 → how-it-works 인벤토리 표와 bug_report.yml 드롭다운에 누락된 항목을
[GAP]으로 보고하고 채워 넣습니다. - 스킬 이름을 변경한 뒤 실행하면 → 옛 이름이 남은 문서 줄을
[STALE]로 잡아내고, 최종 grep으로 잔존 참조가 0인지 확인합니다. - 리파이너의 consumed-by 서술이 "몰레큘이 소비"로 잘못 적힌 경우 →
[WRONG]으로 표시하고 실제 소비 아톰 이름으로 교정합니다.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/techygarg/lattice/HEAD/dev-skills/skill-align/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 techygarg/lattice 의 dev-skills/skill-align 폴더를 내 ~/.claude/skills/skill-align/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/techygarg/lattice.git && mkdir -p ~/.claude/skills && cp -r lattice/dev-skills/skill-align ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 클론합니다:
git clone https://github.com/techygarg/lattice.git - 스킬 폴더가 없으면 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r lattice/dev-skills/skill-align ~/.claude/skills/ references/audit-checklist.md등 동봉 파일이 함께 복사됐는지 확인합니다:ls ~/.claude/skills/skill-align- 중요: 이 스킬은 Lattice 저장소 구조(
skills/,docs/,PROJECT.md,.github/ISSUE_TEMPLATE/)를 전제로 합니다. 해당 저장소 루트에서 Claude Code를 실행하세요. - Claude Code에서 "align docs" 또는 "skill align" 이라고 요청하면 감사가 시작됩니다.
- 다른 프로젝트에 쓰려면 문서 경로 목록과 인벤토리 규칙을 자신의 구조에 맞게 수정하세요.
GitHub에서 원본 보기 ↗라이선스: MIT