Agent Skills
One skill, every tool — install nomoji across 35+ AI coding assistants
nomoji is published as an Agent Skill — an open standard adopted by Claude Code, Cursor, OpenAI Codex, Gemini CLI, and dozens of other AI tools. Install once per tool and every generated file, doc, and commit stays emoji-free.
Install by Tool
Claude Code
RecommendedSkills live in .claude/skills/. The allowed-tools frontmatter pre-approves Read, Grep, Glob, and Bash so nomoji runs without permission prompts.
Project-level
mkdir -p .claude/skills/nomoji && curl https://nomoji.dev/skill -o .claude/skills/nomoji/SKILL.mdUser-level (all projects)
mkdir -p ~/.claude/skills/nomoji && curl https://nomoji.dev/skill -o ~/.claude/skills/nomoji/SKILL.mdSkill is auto-discovered. Use /nomoji to invoke manually, or Claude applies it automatically when generating content.
Cursor
IDESkills live in .cursor/skills/. Cursor auto-discovers them at startup and makes them available in Agent chat.
Project-level
mkdir -p .cursor/skills/nomoji && curl https://nomoji.dev/skill -o .cursor/skills/nomoji/SKILL.mdVia Cursor UI
In Cursor Agent chat, paste the skill URL and Cursor will import it automatically:
https://nomoji.dev/skillUse /nomoji in Agent chat to invoke manually.
OpenAI Codex
CLICodex loads skills from .agents/skills/ (project) or ~/.agents/skills/ (user). The .agents/ path takes precedence over tool-specific directories.
Project-level
mkdir -p .agents/skills/nomoji && curl https://nomoji.dev/skill -o .agents/skills/nomoji/SKILL.mdUser-level
mkdir -p ~/.agents/skills/nomoji && curl https://nomoji.dev/skill -o ~/.agents/skills/nomoji/SKILL.mdCodex auto-detects skill changes. Restart if updates do not appear.
Gemini CLI
CLIGemini CLI supports both .agents/skills/ and .gemini/skills/. Install via the built-in gemini skills command or manually.
Via CLI (recommended)
gemini skills install https://github.com/nomoji/nomoji.dev --path examples/agent-skills/nomojiManual (project-level)
mkdir -p .gemini/skills/nomoji && curl https://nomoji.dev/skill -o .gemini/skills/nomoji/SKILL.mdUser-level
mkdir -p ~/.gemini/skills/nomoji && curl https://nomoji.dev/skill -o ~/.gemini/skills/nomoji/SKILL.mdSkill Directory Paths Reference
| Tool | Project-level | User-level |
|---|---|---|
| Claude Code | .claude/skills/nomoji/SKILL.md | ~/.claude/skills/nomoji/SKILL.md |
| Cursor | .cursor/skills/nomoji/SKILL.md | — |
| OpenAI Codex | .agents/skills/nomoji/SKILL.md | ~/.agents/skills/nomoji/SKILL.md |
| Gemini CLI | .gemini/skills/nomoji/SKILL.md | ~/.gemini/skills/nomoji/SKILL.md |
About the Skill Format
nomoji uses the open Agent Skills standard — a SKILL.md file with YAML frontmatter. The frontmatter drives how each tool discovers and invokes the skill:
---
name: nomoji
description: Enforce no-emoji standards. Use after generating code, docs, comments, logs, CLI output, or commit messages to remove emojis and keep output professional and accessible.
allowed-tools: Read Grep Glob Bash
---- name — how you invoke it manually (
/nomoji) - description — what Claude reads to decide when to auto-apply the skill; front-loaded with key terms
- allowed-tools — pre-approves Read, Grep, Glob, Bash so the skill runs without per-use permission prompts
Customize Your Skill
The /api/skill/:userId endpoint generates a personalized SKILL.md based on your configuration. Use your user ID to embed your exact preset and context settings:
curl https://nomoji.dev/api/skill/YOUR-USER-ID -o SKILL.md