AgentSkillsCN

Gitmoji

当用户提出“使用gitmoji”“在提交中添加gitmoji”“选择合适的gitmoji”“为提交寻找恰当的表情符号”，或在编写应包含gitmoji表情符号的提交信息时，可运用此技能。该技能基于官方gitmoji数据库，为提交信息提供与之匹配的语义表情符号。

SKILL.md
--- frontmatter
name: Gitmoji
description: This skill should be used when the user asks to "use gitmoji", "add gitmoji to commit", "select gitmoji", "find appropriate emoji for commit", or when creating commit messages that should include gitmojis. Provides semantic matching of commit messages to appropriate gitmoji emojis from the official gitmoji database.
version: 0.1.0

Gitmoji Skill

Semantic gitmoji selection for commit messages. Reads gitmoji index, analyzes commit message, selects appropriate emoji prefix. Augments /commit workflow.

When to Use

Use when: User requests gitmoji • Integrated into /commit skill • Projects using gitmoji conventions • CLAUDE.md specifies gitmoji usage

Execution Protocol

1. Read Gitmoji Index

Index: Read skills/gitmoji/cache/gitmojis.txt (~75 entries, format: emoji - name - description)

If index missing, run: skills/gitmoji/scripts/update-gitmoji-index.sh

2. Analyze Commit Message

Understand semantic meaning:

  • •Type: bug fix • feature • docs • refactor • performance • config • test • deps
  • •Scope: code structure • dependencies • security • CI • architecture
  • •Impact: critical hotfix • breaking change • minor update • WIP

3. Select Gitmoji

Matching criteria:

  • •Primary: Direct semantic alignment (fix bug → 🐛, add feature → ✨, improve perf → ⚡️)
  • •Secondary: Urgency (critical → 🚑️ vs regular 🐛), scope (docs → 📝), special cases (initial → 🎉)

Selection rules:

  • •Most specific gitmoji matching primary intent
  • •Multiple matches → prefer most significant aspect
  • •Avoid generic when specific available
  • •Consider project conventions

4. Return Format

Return emoji character only (not name/code): 🐛 ✓ • :bug: ✗ • "bug" ✗

Commit format: emoji commit message (example: 🐛 Fix null pointer exception in user authentication)

Integration

Methods:

  • •CLAUDE.md: Always-use instruction
  • •Custom /commit skill: Gitmoji selection step
  • •On-demand: User explicit request

Scope boundary: This skill does NOT analyze git diffs - caller's responsibility. Focuses on semantic matching message→gitmoji only.

Index Maintenance

Update script: skills/gitmoji/scripts/update-gitmoji-index.sh Requirements: curl • jq • internet connection to gitmoji.dev Run when: New gitmojis released • Initial setup • Periodic refresh (monthly)

Critical Rules

Do:

  • •Read entire index (small, efficient)
  • •Semantic matching (not keyword matching)
  • •Return emoji character in commit message
  • •Prioritize primary intent

Don't:

  • •Search/grep index (read entirely)
  • •Use codes (:bug:) instead of emoji (🐛)
  • •Add multiple gitmojis per commit
  • •Skip selection (make best judgment)

Resources

Files:

  • •cache/gitmojis.txt - Official gitmoji index (75 entries)
  • •scripts/update-gitmoji-index.sh - Index updater

Limitations: Internet for initial download • Manual updates • jq dependency • One gitmoji per commit • No git diff analysis