Claude Code Integration Guide

Install the nomoji Agent Skill for automatic emoji-free output

Quick Setup

1. Create skills directory
mkdir -p .claude/skills/nomoji
2. Download skill
curl https://nomoji.dev/skill -o .claude/skills/nomoji/SKILL.md
3. Done!

Claude Code discovers and loads the skill automatically

How It Works

The nomoji skill uses the Agent Skills open standard. Claude Code discovers skills in .claude/skills/ automatically and loads them with progressive efficiency:

  • Level 1 (always active): Skill metadata loaded at startup — Claude knows nomoji exists and when to apply it
  • Level 2 (on demand): Full instructions loaded when relevant — after generating code, docs, or commits

The skill is automatically applied after:

  • Generating or modifying code files
  • Creating or updating documentation
  • Writing console output or logging statements
  • Composing commit messages

Choosing a Preset

Strict Mode

No emojis anywhere (recommended for enterprise)

curl https://nomoji.dev/api/skill/strict-user -o .claude/skills/nomoji/SKILL.md

Moderate Mode

Limited emojis, balanced approach

curl https://nomoji.dev/api/skill/moderate-user -o .claude/skills/nomoji/SKILL.md

Relaxed Mode

Emojis in UI only

curl https://nomoji.dev/api/skill/relaxed-user -o .claude/skills/nomoji/SKILL.md

Project vs User Level

Project-Level (Recommended)

Place skill in your project directory:

.claude/skills/nomoji/SKILL.md

Benefits:

  • Team-wide consistency
  • Version controlled
  • Project-specific configuration

User-Level

Place skill in your home directory:

~/.claude/skills/nomoji/SKILL.md

Benefits:

  • Apply to all projects
  • Personal defaults
  • No per-project setup needed

Usage Examples

Automatic Application

Claude Code applies nomoji automatically when relevant:

You: Update the README with installation instructions

Claude: [Generates README — nomoji skill active, no emojis added]

Explicit Invocation

Request nomoji specifically:

You: Use nomoji to check my recent commits

nomoji: Scanning commit history...
Found 2 commits with emojis in messages

Troubleshooting

Skill Not Being Applied?

  1. Check file location: .claude/skills/nomoji/SKILL.md
  2. Verify YAML frontmatter is present (name and description fields)
  3. Make sure description explains when to use the skill
  4. Try explicit invocation: "Use nomoji to check this"

Wrong Behavior?

  1. Check the rules in SKILL.md match your expectations
  2. Update your configuration at nomoji.dev/setup
  3. Re-download a fresh SKILL.md

Team Setup

Share configuration with your team:

  1. Download skill to your project
  2. Commit to version control:
    git add .claude/skills/nomoji/SKILL.md && git commit -m "Add nomoji Agent Skill"
  3. Team members pull and Claude Code auto-discovers the skill

Related Resources