convez.ai
SkillProdutividadeIntermediário
CommitTheKermit

AO Skills - Coleção de Skills e Slash Commands

CommitTheKermit/ao-skills

Skills e comandos para Claude Code: PRs, STT, design handoff e automação de fluxos

Ver no GitHub
InicialPluginScore · de 0 a 100

Repositório de skills customizados e slash commands para Claude Code, com automações para fluxos de trabalho comuns como gestão de PRs, síntese de STT, aprendizado socrático e sincronização de mudanças. Inclui 3 skills acionáveis automaticamente e 7 comandos disparáveis manualmente.

Instalação

$npx convez-ai CommitTheKermit/ao-skills

1 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

Estrelas
7
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 dias
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Escrever descrições e respostas de PRs com formato padronizado
  • Sincronizar designs do Claude Design com o código via handoff links
  • Refinar transcrições STT em versões revisadas e resumidas
  • Gerenciar skills/comandos com workflow automatizado (atualizar, sincronizar, commitar)
  • Aprender conceitos em modo socrático interativo
  • Organizar PRs como TODOs estruturados no Notion

Veredito

Coleção pragmática de automações para fluxos reais de desenvolvimento e conhecimento em Claude Code. O destaque é o `ao-skill-update` que fecha o loop: modificar skills/comandos, sincronizar globalmente e fazer commit tudo em um comando. Estrutura bem documentada, mas requer instalação manual e conhecimento de git.

README

A tradução para o português deste README ainda está na fila.

ao-skills

Claude Code에서 사용 중인 개인 스킬(Skill)과 슬래시 커맨드(Slash Command) 모음.

구성

ao-skills/
├── skills/
│   ├── ao-skill-update/     # 스킬/커맨드 변경 워크플로우 스킬
│   │   └── SKILL.md
│   ├── claude-design-handoff/ # claude.ai/design 핸드오프 링크로 디자인 소스 최신화 스킬
│   │   └── SKILL.md
│   └── release-commit/      # 배포/릴리스 직후 release 커밋을 고정 포맷으로 작성하는 스킬
│       └── SKILL.md
└── commands/
    ├── socratic-learn.md    # /socratic-learn - 소크라테스식 학습 모드 진입
    ├── session-handoff.md   # /session-handoff - 세션 문맥 핸드오프 산출물 생성
    ├── stt-refine.md        # /stt-refine - STT 녹취록을 검수본·요약본으로 변환
    ├── pr-todo-notion.md    # /pr-todo-notion - PR을 노션 체크박스 TODO로 정리
    ├── pr-description.md    # /pr-description - PR 디스크립션 작성
    ├── pr-review-answer.md  # /pr-review-answer - PR 리뷰 답변 작성
    └── ao-skill-update.md   # /ao-skill-update - 스킬/커맨드 변경+동기화+커밋+푸시

스킬 vs 커맨드

구분커스텀 커맨드스킬
호출사용자가 /명령 입력사용자 호출 + 조건 만족 시 자동 발동
구조단일 .md 파일디렉토리 + SKILL.md (+ 보조 자원)
메타데이터거의 없음frontmatter description으로 발동 조건 명시
용도자주 쓰는 프롬프트 재사용재사용 가능한 "능력/워크플로우" 패키징

설치

전역 설치 (모든 프로젝트에서 사용)

# 이 레포를 임의 위치에 클론
git clone https://github.com/CommitTheKermit/ao-skills.git
cd ao-skills

# 스킬/커맨드를 ~/.claude 아래에 복사
mkdir -p ~/.claude/skills ~/.claude/commands
cp -R skills/* ~/.claude/skills/
cp commands/* ~/.claude/commands/

프로젝트 단위 설치

# 프로젝트 루트에서
mkdir -p .claude/skills .claude/commands
cp -R /path/to/ao-skills/skills/* .claude/skills/
cp /path/to/ao-skills/commands/* .claude/commands/

설치 후 Claude Code를 재시작하면 인식됩니다.

스킬 목록

스킬은 description이 매 대화에 상시 로드되어 자동 발동을 판단한다. 그래서 "자동 발동이 핵심 가치"이거나 "레포 운영에 필수"인 것만 스킬로 둔다. 명시 호출이 자연스러운 기능은 커맨드로 둬서 상시 토큰을 아낀다.

ao-skill-update

이 레포의 스킬/커스텀 커맨드를 추가/수정/삭제한 뒤 ~/.claude/로 동기화하고 커밋과 푸시까지 자동 처리하는 워크플로우.

발동 표현: "스킬 만들자", "스킬 수정", "커맨드 추가", "커맨드 변경", "스킬 동기화" 등.

claude-design-handoff

claude.ai/design 핸드오프 링크(api.anthropic.com/v1/design/...)를 받아 디자인 번들을 내려받고(gzip bin → gunzip+tar 압축해제), 번들의 README와 prod 산출물(app-prod.jsx/styles-prod.css 등)·chats/ 트랜스크립트를 근거로 프로젝트의 디자인 소스를 시안과 정확히 동기화한다. 텍스트 설명만으로 추측 구현하지 않는다. 함께 온 구체적 변경 지시도 추가 반영.

발동 표현: "Fetch this design file, read its readme, and implement..." 형식 또는 api.anthropic.com/v1/design/ 링크 붙여넣기.

release-commit

배포/릴리스 직후 남기는 release 커밋을 고정 포맷(chore(release): vX.Y.Z 배포)으로 작성한다. 직전 release 이후의 git log를 뽑아 변경 목록·배포 대상·버전 증감을 본문에 채워, 요약 한두 줄로 끝나 추적이 안 되는 빈약한 release 커밋을 막는다.

발동 표현: "release 커밋", "버전 커밋", "릴리스 커밋", "배포 커밋 정리" 등.

커맨드 목록

커맨드설명
/socratic-learn소크라테스식 점진 학습 모드 진입
/session-handoff작업 세션 문맥을 핸드오프 프롬프트 + handoff.md로 정리
/stt-refineSTT 녹취록을 검수본·요약본 두 마크다운으로 변환 (통합본 포함)
/pr-todo-notionGitHub PR을 Notion 단순 체크박스 TODO 페이지로 정리
/pr-descriptionPR 디스크립션을 정해진 형식으로 작성
/pr-review-answerPR 리뷰 코멘트 질문에 대한 답변을 정해진 형식으로 작성
/ao-skill-update스킬/커맨드 변경 + 전역 동기화 + 커밋 + 푸시

최근 변경내역

2026-06-10 - /learn → /socratic-learn 리네임 + ao-skill-update 신규 분류 단계 추가

  • 변경 1: commands/learn.md → commands/socratic-learn.md (호출 /socratic-learn). 스킬 시절 이름과 일치시켜 일관성 확보
  • 변경 2: ao-skill-update 워크플로우의 "변경 분류"에, 신규 추가 시 스킬로 저장할지 커맨드로 저장할지 사용자에게 반드시 묻는 단계 추가. 판단 기준(자동 발동·상시 토큰 필요 → 스킬, /이름 명시 호출로 충분 → 커맨드)을 함께 제시
  • 영향 파일: commands/socratic-learn.md(리네임), skills/ao-skill-update/SKILL.md, commands/ao-skill-update.md, README.md

2026-06-10 - socratic-learn/session-handoff/stt-refine/pr-todo-notion 스킬 → 커맨드 전환

  • 기존: 4개 기능이 스킬로 존재해 자동 발동용 description(167~366자)이 매 대화 상시 로드됨
  • 변경: 4개를 커스텀 커맨드(/session-handoff, /stt-refine, /pr-todo-notion, 기존 /learn)로 이전하고 스킬은 삭제. learn.md는 socratic-learn 참조를 제거해 자족화
  • 이유: 스킬은 자동 발동 판단을 위해 긴 description을 상시 로드하지만, 이 4개는 사용자가 명시 호출(/명령)하는 게 자연스러워 자동 발동 이득이 작음. 커맨드는 짧은 한 줄 description으로 충분해 상시 토큰을 절감 (자동 발동은 포기)
  • 유지: ao-skill-update(레포 운영 필수), claude-design-handoff(링크 붙여넣기 자동 발동이 핵심), release-commit은 스킬로 유지
  • 영향 파일: commands/learn.md, commands/session-handoff.md(신규), commands/stt-refine.md(신규), commands/pr-todo-notion.md(신규), skills/{socratic-learn,session-handoff,stt-refine,pr-todo-notion}/(삭제), README.md

2026-06-09 - 신규 추가: release-commit 스킬

  • 종류: 스킬
  • 목적: 배포/릴리스 직후 남기는 release 커밋을 고정 포맷(chore(release): vX.Y.Z 배포)으로 작성하고, 본문은 직전 release 이후의 git log 를 뽑아 변경 목록·배포 대상·버전 증감으로 채운다. 요약 한두 줄로 끝나 추적이 안 되는 빈약한 release 커밋을 방지.
  • 영향 파일: skills/release-commit/SKILL.md, README.md

2026-06-08 - 신규 추가: claude-design-handoff 스킬

  • 종류: 스킬
  • 목적: 전역 CLAUDE.md의 "클로드 디자인 링크 처리" 규칙을 독립 스킬로 분리. claude.ai/design 핸드오프 링크를 받아 번들을 내려받아 압축 해제하고, README와 prod 산출물·chats 트랜스크립트를 근거로 프로젝트 디자인 소스를 시안과 동기화한다.
  • 영향 파일: skills/claude-design-handoff/SKILL.md, README.md

2026-06-08 - pr-todo-notion 산출물 단순화

  • 기존: PR 링크 헤더 + 팀/리뷰어 메타 줄 + 각 TODO에 코멘트 링크 매핑 + "본문 파생 TODO"/"후속 작업" 섹션 분리
  • 변경: 기존 노션 리뷰 TODO 페이지와 100% 동일한 단순 형식(## N차 리뷰 TODO (날짜, 상태) 헤더 + - [ ] 할 일 (위치) + 세부 근거)만. 코멘트 링크/메타/파생·후속 섹션 제거
  • 이유: 산출물이 기존 노션 페이지 형식 대비 과하게 복잡 → 워크스페이스의 기존 리뷰 TODO 페이지 형식에 맞춰 단순화
  • 영향 파일: skills/pr-todo-notion/SKILL.md, README.md

2026-06-04 - ao-skill-update 커밋 서명 트레일러 제거

  • 기존: 커밋에 Co-Authored-By: Claude ... 서명 트레일러 포함 지시
  • 변경: 서명 트레일러를 넣지 않도록 수정
  • 이유: 전역 CLAUDE.md의 "서명 트레일러 넣지 않음" 규칙과 충돌 → 전역 규칙에 맞춤
  • 영향 파일: skills/ao-skill-update/SKILL.md, commands/ao-skill-update.md, README.md

2026-06-04 - session-handoff 핸드오프 파일 구조 변경

  • 기존: 산출물을 저장소 루트 HANDOFF.md 단일 파일로 저장
  • 변경: 최신 진입점을 루트 handoff.md(고정 파일명, 덮어쓰기)로 두고, 이력은 handoff/handoff_yyMMdd_HHmm.md(콜론 없는 타임스탬프)로 아카이브
  • 이유: Claude Code @ 파일 멘션 정렬 기준이 미문서화라 "최신이 맨 위"를 보장 못 함 → 정렬에 의존하지 않고 고정 진입점 하나로 단일화
  • 영향 파일: skills/session-handoff/SKILL.md, README.md

2026-06-03 - 신규 추가: session-handoff 스킬

  • 종류: 스킬
  • 목적: 현재 작업 세션의 문맥을 다음 세션으로 넘기기 위해 핸드오프 프롬프트 + HANDOFF.md 두 산출물을 생성한다.
  • 영향 파일: skills/session-handoff/SKILL.md, README.md

2026-06-02 - 신규 추가: stt-refine 스킬

  • 종류: 스킬
  • 목적: STT 녹취록을 맥락 기반으로 보정한 검수본과 토픽별 재구성 요약본 두 개의 마크다운으로 변환 (연속 회차 통합본 포함)
  • 영향 파일: skills/stt-refine/SKILL.md, README.md

2026-06-02 - 신규 추가: pr-todo-notion 스킬

  • 종류: 스킬
  • 목적: GitHub PR을 분석해 Notion 페이지 아래에 TODO 하위 페이지를 만들고, 각 TODO 제목에 근거 리뷰 코멘트 링크를 매핑해 추적 가능하게 함
  • 영향 파일: skills/pr-todo-notion/SKILL.md, README.md

2026-05-18 - 신규 추가: ao-skill-update 스킬 / /ao-skill-update 커맨드

  • 종류: 스킬 + 커맨드 (페어)
  • 목적: 스킬/커맨드 변경 시 레포를 단일 진실 소스로 두고 ~/.claude/로 cp -R 동기화 후 커밋+푸시까지 일괄 처리
  • 영향 파일: skills/ao-skill-update/SKILL.md, commands/ao-skill-update.md, README.md

2026-05-18 - socratic-learn / /learn 사이클 단순화

  • 기존: 응답 1(설명) → 응답 2(확인 질문) → 응답 3(채점) 의 3-응답 구조
  • 변경: 응답 1(설명 + 확인 질문) → 응답 2(사용자 답 → 채점 + 분기) 의 2-응답 구조
  • 이유: 설명 직후 질문을 받아야 학습자가 답할 타이밍을 놓치지 않음. 사이클 호흡을 짧게 가져감.
  • 영향 파일: commands/learn.md, skills/socratic-learn/SKILL.md
Ver o original no GitHub

Bom para

Relacionados