OpenCode Skills 가이드: 재사용 가능한 AI 코딩 워크플로 7가지 규칙

OpenCode skills는 반복되는 코딩 작업을 위한 재사용 가능한 지침 묶음입니다. 절차, 도메인 규칙, 리뷰 기준을 OpenCode가 일관되게 따르게 할 때 사용합니다. 비밀 저장소나 agent, MCP의 대체물로 사용하지 마세요. 같은 지시를 여러 프롬프트에 반복해서 쓰고 있다면 skill로 만들 가치가 있습니다. 일회성 메모는 프롬프트에, 영구 선호는 설정이나 문서에 둡니다.

같은 지시를 여러 프롬프트에 반복해서 쓰고 있다면 skill로 만들 가치가 있습니다. 일회성 메모는 프롬프트에, 영구 선호는 설정이나 문서에 둡니다.

작은 작업을 skill 적용 전후로 비교하는 것이 가장 확실합니다. 반복 설명이 줄고 diff가 좋아지면 유지합니다.

프로젝트 skill은 영향을 받는 코드와 가까워 리뷰하기 쉽습니다. 글로벌 skill은 다른 저장소에도 영향을 줄 수 있으므로 정말 보편적인 습관에만 사용합니다.

프레임워크, 배포 대상, 글쓰기 톤, 준수 규칙이 들어가면 대개 프로젝트 skill로 두는 것이 안전합니다.

같은 지시를 여러 프롬프트에 반복해서 쓰고 있다면 skill로 만들 가치가 있습니다. 일회성 메모는 프롬프트에, 영구 선호는 설정이나 문서에 둡니다.

skill은 행동 지침, command는 이름 있는 동작, agent는 역할과 문맥 분리, MCP는 외부 도구 연결입니다.

프로젝트 skill은 영향을 받는 코드와 가까워 리뷰하기 쉽습니다. 글로벌 skill은 다른 저장소에도 영향을 줄 수 있으므로 정말 보편적인 습관에만 사용합니다.

skill은 목적, 트리거, 단계, 제한, 기대 증거가 있는 작은 계약처럼 작성합니다. 테스트할 수 없으면 너무 넓습니다.

같은 지시를 여러 프롬프트에 반복해서 쓰고 있다면 skill로 만들 가치가 있습니다. 일회성 메모는 프롬프트에, 영구 선호는 설정이나 문서에 둡니다.

먼저 최소 템플릿으로 시작하고 자리표시자를 실제 저장소 명령으로 바꾸세요. 작은 skill이 유지보수하기 쉽습니다.

---
name: repository-review
description: Use when reviewing code changes in this repository.
---

# Repository Review

1. Inspect the changed files and nearby tests before giving findings.
2. Prioritize bugs, regressions, security risks, and missing validation.
3. Run the documented test command when the touched area has one.
4. Report findings first with file and line references.
5. If no issue is found, say so and mention residual test risk.

프로젝트 skill은 영향을 받는 코드와 가까워 리뷰하기 쉽습니다. 글로벌 skill은 다른 저장소에도 영향을 줄 수 있으므로 정말 보편적인 습관에만 사용합니다.

비밀은 환경 변수, provider 인증, 비밀번호 관리자에 둡니다. skill은 처리 방식을 설명할 뿐 token을 담지 않습니다.

같은 지시를 여러 프롬프트에 반복해서 쓰고 있다면 skill로 만들 가치가 있습니다. 일회성 메모는 프롬프트에, 영구 선호는 설정이나 문서에 둡니다.

결과가 나빠지면 전체 skill, 짧은 버전, 일반 prompt를 비교하세요. 겹치는 지시를 찾기 쉽습니다.

AGENTS.md 규칙을 subagents로 나누기 전에 OpenCode agents 가이드에서 역할과 도구 경계를 확인하세요. OpenCode agents 가이드.