How — 코드베이스를 설명하는 Cursor 스킬

/how 스킬을 추가하는 Cursor 플러그인: 하위 시스템, 기능, 또는 흐름이 어떻게 작동하는지 물어보면, 에이전트가 새로운 영역에 배치되는 시니어 엔지니어 수준의 명확한 아키텍처 설명을 제공합니다.

기능

질문에 따라 자동으로 선택되는 두 가지 모드:

• 설명(Explain, 기본값) — 코드베이스를 탐색하고, 개요(Overview), 핵심 개념(Key Concepts), 작동 방식(How It Works), 위치(Where Things Live), 주의사항(Gotchas) 섹션으로 구성된 구조화된 설명을 생성합니다.
• 비평(Critique) — 먼저 설명을 제공한 후, 여러 모델에 독립적인 비평가를 생성하여 아키텍처 문제를 도출합니다.

여러 파일이나 서비스를 아우르는 복잡한 질문의 경우, 이 스킬은 질문을 2~4개의 병렬 탐색 각도로 분解하고, 탐색 결과를 병렬로 수집하는 서브 에이전트를 생성합니다. 그런 다음 종합(synthesis) 에이전트가 이들의 결과를 단일 일관된 설명으로 조정합니다. 간단한 질문은 팬아웃(fan-out)을 건너뛰고 단일 에이전트에서 끝까지 실행됩니다.

예시 프롬프트

• "메시지 가상화(message virtualization)는 어떻게 작동합니까?"
• "사용자가 메시지를 보낼 때 어떤 일이 일어나는지 단계별로 설명해 주세요."
• "인증(auth) 서비스 구조는 어떻게 되나요? 설계도 비평해 주세요."
• "인증 미들웨어(auth middleware)는 권한을 어떻게 확인합니까?"

구조

SKILL.md는 최상위 라우팅 로직(간단 vs. 복잡, 설명 vs. 비평)을 포함합니다. references/ 폴더에는 에이전트가 각 서브 에이전트에게 전달할 프롬프트 템플릿과 비평 단계에서 사용되는 평가 기준(rubric)이 포함되어 있습니다.

라이선스

MIT

---

🚀 가벼운 미리보기 모드: 페이지 속도를 위해 핵심 도입부만 번역되었습니다. 전체 코드는 원문 GitHub에서 확인하세요!