UBISAM Minutes — Redação Automática de Atas
NohDoyeon241104/ubisam-minutes-skill
Converte notas brutes de reunião em atas estruturadas com 6 templates
Ver no GitHubSkill que transforma anotações de reunião soltas em atas formatadas automaticamente, com 6 tipos de templates (básico, desenvolvimento, executivo, kick-off, troubleshooting, cliente). Funciona tanto em claude.ai web quanto em Claude Code com CLI e formulário UI opcional.
Instalação
npx convez-ai NohDoyeon241104/ubisam-minutes-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Padronizar redação de atas em equipes remotas/híbridas
- Extrair atas de transcrições STT ou resumos Webex
- Documentar reuniões técnicas (dev, troubleshooting, kick-off) com estrutura consistente
Veredito

Ferramenta bem pensada para contexto corporativo coreano, mas com execução genérica. O README em coreano dificulta adoção imediata fora do nicho. A dualidade web+CLI é inteligente; templates de 6 tipos mostram maturidade. Recomendado para times que já têm Claude Enterprise.
README
A tradução para o português deste README ainda está na fila.
UBISAM 회의록 작성 Skill — 팀 사용 가이드
갈겨쓴 회의 메모 / STT 녹취 / Webex 요약을 일정한 형식의 회의록으로 자동 작성한다. 회의 유형(6종)을 선택하면 해당 고정 템플릿으로 정리된다.
두 가지 방식으로 쓸 수 있다.
- 방식 1 (웹): 설치 없이 claude.ai 에 가이드 파일 첨부 → 가장 쉬움
- 방식 2 (CLI): Claude Code 로 워크스페이스에서 실행 → 자동 저장·UI 폼
방식 2를 쓰려면 아래 [방식 2] 안의 "준비물"부터 설치한다.
방식 1 — claude.ai 웹 (설치 불필요, 가장 쉬움)
비개발자 팀원에게 추천. 무료 계정도 가능.
- claude.ai 접속
- 대화창의 📎 아이콘 →
templates/회의록_AI작성_가이드_v1.md첨부 (이 파일은 GitHub 레포에서 내려받거나, 팀에서 공유받는다) - 아래 프롬프트 붙여넣기:
첨부한 "회의록 AI 작성 가이드"의 형식과 규칙에 맞춰 회의록을 작성해줘.
[회의 메타정보]
- 날짜:
- 참석자: (이름 직급 형식으로)
- 회의 주제:
- 유형: 1)기본 2)개발 3)경영보고 4)킥오프 5)트러블슈팅 6)고객미팅 중 택1
[내가 갈겨쓴 메모]
(여기에 메모 붙여넣기)
가이드 파일 하나만 첨부하면 끝. 자세한 사용법·FAQ는 그 파일 안에 다 있다.
방식 2 — Claude Code (CLI, 워크스페이스에서)
자동 저장·UI 폼을 쓸 수 있다.
준비물 (최초 1회 설치)
아래 3가지가 PC에 있어야 한다. 이미 있으면 건너뛴다.
(1) Git — 확인 git --version / 없으면 https://git-scm.com/download/win
(2) Python — UI 폼(main_ui.py)을 쓸 때만 필요. claude로 작성만 할 거면 건너뛰어도 됨
- 확인
py --version - 없으면 PowerShell에서
winget install Python.Python.3.12→ 창 닫고 새로 열기 - ⚠️
python이 "인식 안 됨"으로 나오면py를 대신 쓴다 (기능 동일)
(3) Claude Code — 확인 claude --version
- 없으면 PowerShell에서
irm https://claude.ai/install.ps1 | iex - 설치 위치:
C:\Users\<사용자>\.local\bin\claude.exe claude가 "인식 안 됨"으로 나오면 → 아래 [문제 해결] PATH 등록 참고
레포 받기 (최초 1회)
cd C:\Work # 원하는 폴더
git clone https://github.com/NohDoyeon241104/ubisam-minutes-skill.git
cd ubisam-minutes-skill
사내 NAS Gitea를 쓰면 clone 주소만 사내 주소로 바꾼다.
사용
레포 폴더 안에서 claude 실행:
cd C:\Work\ubisam-minutes-skill
claude
claude가 뜨면:
SKILL.md 규칙대로 아래 회의 메모를 회의록으로 작성해줘. 유형은 2번(개발).
결과는 output/에 저장해줘.
(메모 붙여넣기)
- 결과:
output/회의록_주제_YYYYMMDD.md output/,uploads/내용물은 Git에 안 올라간다 (각자 로컬 보관).- 이 skill은 텍스트만 다루므로 python-pptx 같은 추가 패키지가 필요 없다.
UI 폼으로 입력하기 (메타정보·유형·파일 한 번에)
claude와 별도 터미널에서 폼 실행:
py scripts\main_ui.py
폼이 뜨면:
- 날짜·참석자·주제 입력, 유형(1~6) 선택
- 메모 붙여넣기 또는 파일 선택, 보조소스(STT/Webex) 선택(선택)
- ① 프롬프트 생성 → ② 복사
- claude 창에 붙여넣기 → 회의록 작성
폼이 메타정보·유형·파일경로를 자동으로 채운 프롬프트를 만들어주므로, 항목 누락 없이 일관된 입력이 된다.
회의 유형 6종
| 번호 | 유형 | 쓰임 |
|---|---|---|
| 1 | 기본형 | 일반 업무 회의 |
| 2 | 개발팀형 | 아키텍처/브랜치/자동화/환경 |
| 3 | 경영·전략형 | 보고·승인, 배포 대상 명시 |
| 4 | 킥오프형 | 프로젝트 착수 (범위·일정·역할·리스크) |
| 5 | 트러블슈팅형 | 장애·이슈 대응 (증상·원인·조치·재발방지) |
| 6 | 고객/외부미팅형 | 요구사항·합의사항·후속 |
각 유형이 어떤 섹션으로 작성되는지, 실제 예시는 어떤 모습인지는
examples/회의록_6유형_안내.html을 브라우저로 열어 한눈에 확인할 수 있다. 유형별 작성 예시 원문은examples/유형N_*.md에 있다.
핵심 작성 규칙 (AI가 지키는 것)
- 사실만 기록, 추측 금지. 불확실하면
(확인 필요). - 고유명사 보존 — 이름·레포명·경로는 그대로. 오인식 의심 시 표시만.
- 결정 / 논의 / 액션 분리.
- 액션 아이템:
- [ ] (담당자) 할 일 — 기한. - 외부 반출 금지 소스·세부 경로는 본문에 노출 안 함.
최신 버전 받기
cd C:\Work\ubisam-minutes-skill
git pull
output/,uploads/에 만든 내 파일은 그대로 보존된다 (추적 대상 아님).- 코드·템플릿·SKILL.md만 최신으로 갱신된다.
문제 해결
| 증상 | 해결 |
|---|---|
python 인식 안 됨 | py 로 대체 사용 |
py 도 안 됨 | winget install Python.Python.3.12 → 창 새로 열기 |
claude 인식 안 됨 | 아래 PATH 등록 |
git 인식 안 됨 | git-scm.com 에서 설치 |
| 규칙/템플릿 인식 못 함 | 반드시 레포 폴더 안에서 claude 실행 |
claude PATH 등록 (GUI — 안전): Win+R → sysdm.cpl → 고급 → 환경 변수 →
사용자 변수 Path 편집 → 새로 만들기 → C:\Users\<사용자>\.local\bin 추가 →
확인 → 터미널 새로 열기. (setx는 PATH가 길면 잘릴 수 있어 GUI 권장)
폴더 구성
ubisam-minutes/
├── README.md
├── SKILL.md ← 작성 규칙 + 유형 매핑 + 확장 템플릿 D/E/F
├── scripts/
│ └── main_ui.py ← 입력 폼 + 자동 프롬프트 생성기 (tkinter)
├── templates/
│ ├── 회의록_AI작성_가이드_v1.md ← 본체 (규칙+템플릿 A/B/C+예시+FAQ). 웹 방식은 이것만 첨부
│ ├── 회의록_작성_가이드.md ← 축약 이전 버전
│ └── 회의록_템플릿_기본.md ← 빈 템플릿
├── uploads/ ← UI로 올린 입력 (로컬 전용)
└── output/ ← 결과물 (로컬 전용)