사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/jkappers/agent-skills --skill conventional-commit시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Commit Authoring
Create git commits following Conventional Commits v1.0.0.
When invoked with arguments, commit staged changes with a message for: $ARGUMENTS
This skill applies only to git commit messages. Do not apply these conventions to PR titles, branch names, changelog entries, or release notes unless explicitly requested.
Workflow
- Run
git diff --cachedto inspect staged changes - If no staged changes exist, report this and stop
- Analyze the diff to determine the appropriate type, scope, and description
- Compose the commit message following the rules below
- Run
git commit -m "<message>"(use a HEREDOC for multi-line messages) - Do not stage files. Only commit what is already staged.
Message Structure
<type>[optional scope]: <description>
[optional body]
[optional footer(s)]Types
| Type | Purpose |
|---|---|
feat | New feature |
fix | Bug fix |
docs | Documentation only |
style | Formatting, whitespace |
refactor | Neither fix nor feature |
perf | Performance improvement |
test | Adding or updating tests |
build | Build system or dependencies |
ci | CI configuration |
chore | Maintenance tasks |
Scopes
Scope is optional. When used, set it to the module, component, or area of the codebase affected.
Derive scopes from the project structure. Use directory names or module names, not file names.
Examples: feat(auth):, fix(api):, docs(readme):, refactor(db):
Omit scope when the change is cross-cutting or affects the project root.
Description
Use imperative mood: "add feature" not "added feature" or "adds feature". Lowercase the first letter after the type prefix. Omit trailing period. Limit to 50 characters.
Body
Wrap at 72 characters. Explain what changed and why, not how.
Separate the body from the description with one blank line.
Use the body for context the diff alone does not convey: motivation, trade-offs, or constraints that influenced the approach.
Prohibited Content
Do not include any of the following in commit messages:
- AI attribution ("Generated with Claude Code", "Co-authored-by" lines for AI)
- Emoji in type prefixes or descriptions
- Time estimates or dates
- TODO items or future work references
- File lists (the diff already shows what changed)
- Apologies or hedging ("try to fix", "hopefully resolves")
Examples
Simple:
docs: correct spelling of CHANGELOGWith scope:
feat(lang): add Polish languageBreaking change:
feat!: send email to customer when product ships
BREAKING CHANGE: customers now receive emails by default.With body:
fix: prevent duplicate form submissions
Disables submit button after first click and adds
debounce to the handler.With footer:
fix: resolve race condition in auth flow
Refs: #123
Reviewed-by: Alice