Spell-check at commit time with typos, blocking only on typos in lines a commit adds.
- GitHub stars
- 32
What it does
- Adds a
lintgit pre-commit entry, thesetupskill, and an opt-in end-of-turn Stop hook - Covers registering the git hook through lefthook, husky, or plain git hooks, with local or shared scope
- Honors your repository's typos configuration, merging the bundled default config through
extend-*keys - Designed for teams that want spelling findings to reach every author, including Claude and other agents
Spell-check at commit time via typos-cli: a git pre-commit lint entry that blocks only on typos in the lines a commit adds, with an opt-in end-of-turn check, honoring the consuming repo's own typos configuration; hooks never run an ecosystem record's command.
Add marketplace
/plugin marketplace add melodic-software/claude-code-pluginsRun it inside Claude Code once, then install the plugin below.
Install
/plugin install spelling@melodic-softwareRun it inside Claude Code after adding the marketplace.
Files
Discovered from sourceReadme
spelling
A Claude Code plugin that spell-checks with typos at commit time. Findings arrive when you commit, from a git pre-commit entry that blocks only on a typo in a line the commit adds, so they reach every author: Claude, other agents and people. Nothing is reported while Claude edits. An opt-in end-of-turn check hands findings in the uncommitted changes back to Claude before a turn ends.
The check honors your repository's own typos configuration and runs with or without one: typos
discovers it from the checked path, and the plugin's bundled config/default-typos.toml (passed
with -c, so that SHA-shaped hex is not read as a misspelling) merges with it through extend-*
keys. Pointer: the Sources list in typos' configuration reference.
The hooks run only this typos adapter (git-hooks/adapters.sh). They never run a command from a
.claude/ecosystems/spelling.yaml record; /toolchain:lint and /toolchain:check run its
lint-cmd on request, and /spelling:setup check says when one exists.
Git pre-commit entry
The plugin ships one git-hook entry, lint (git-hooks/entries.json): a pre-commit
check that blocks a commit only on a typo in a line the commit adds, printed as
<path>:<line>: <message>. It reports and never rewrites a file. A typo on a line the commit
leaves alone never blocks, a partly staged file is checked as staged, and your config's excludes
hold for every path. typos exiting with an error and no finding blocks the commit and shows its
output. It replaces the earlier typos-check entry: /spelling:setup check reports an installed
typos-check copy as superseded, apply install-git-hooks retires it, and a decline of
typos-check carries to lint. The entry
runs once /spelling:setup apply install-git-hooks [scope=local|shared] registers it with the
repository's hook manager (lefthook, husky or plain git hooks). Local scope stays in this clone;
shared scope commits the copy under .githooks/spelling/. The bundled
config/default-typos.toml is copied beside it. /spelling:setup check reports drift, and the
SessionStart probe prints one line when the entry is missing, stale or edited.
When typos is missing, an agent's commit fails with the install command; a person's commit gets a
one-line notice and goes through. git -c checks.skipmissing=typos commit ... skips the check
while typos is absent. The placement rules are the check-placement convention in the
marketplace repository.
End-of-turn check (opt-in)
With spelling_end_of_turn on, a Stop hook runs the same check over the lines changed since
the last commit, untracked files included. Findings go back to Claude with exit 2, so they are
fixed before the turn ends; once a Stop hook has continued the turn it stays quiet, so it blocks at
most once per turn. Off, its default, a turn end costs one process: the node launcher, whose gate
closes before bash starts (scripts/hook-census.sh, WSL2 Ubuntu, 2026-10-15, fenced by
.performance/ratchets.json). On, a clean work tree measured 19 process creations and execs on the
same host.
Requirements
- typos on
PATH, installed at the machine level by the machine's owner (install typos). It is never downloaded on the fly. The SessionStart probe reports a missingtyposonce per session fromprerequisites.json. - Bash runs the check (3.2 or newer, so macOS's own bash works). On native Windows, install Git for Windows.
- Node.js on
PATHfor the Claude Code rows, which launch throughnode hooks/exec-bash.mjs, and for the installer the setup skill runs.node "<plugin root>/lib/prerequisites.mjs" check "<plugin root>"reports what resolves; it is read-only and installs nothing.
Install
/plugin marketplace add melodic-software/claude-code-plugins
/plugin install spelling@melodic-software
Then verify prerequisites with /spelling:setup check.
Configuration
The rules themselves are never configured here. They come from the typos config already in your repository, which the plugin reads automatically. To change the rules (allowlist a false positive, ignore a pattern), edit that file.
Two userConfig options tune the Claude Code hooks; the git pre-commit entry has none:
| Option | Default | Effect |
|---|---|---|
spelling_enabled | true | Kill switch for the SessionStart probe and the end-of-turn check. The installed git pre-commit entry keeps running. |
spelling_end_of_turn | false | Set true to run the pre-commit check over the uncommitted changes when a turn ends; findings go back to Claude once per turn so they are fixed before it stops. |
Set them interactively with /plugin configure spelling@<marketplace>, or headless on the
install command:
claude plugin install spelling@<marketplace> --config spelling_enabled=false
Options reference
Generated from this plugin's .claude-plugin/plugin.json. For how Claude Code asks for
these and hands them to the plugin, see User configuration.
| Option | Type | Default | Description |
|---|---|---|---|
spelling_enabled | boolean | true | Kill switch for the plugin's Claude Code hooks: the SessionStart probe and drift line, and the opt-in end-of-turn check. On by default. The git pre-commit entry is installed separately and is not affected. |
spelling_end_of_turn | boolean | false | At the end of each turn, run the pre-commit lint entry over the lines changed since the last commit and hand any findings back so they are fixed before the turn ends, at most once per turn. Off by default. |
How to set these
Set the options above for spelling@<marketplace>, replacing <marketplace> with the
marketplace you installed this plugin from:
- In a session or headless:
/pluginin a session orclaude plugin configure. The configure command is the preferred headless route in the plugin-reconfiguration convention, which records its limits. - By hand: under
pluginConfigsin your user settings.
Do not uninstall the plugin to reconfigure it: see What an uninstall deletes and keeps.
For a Claude Code release without plugin configure, see Plugin install.
Upstream documentation
- User configuration
- Plugin configure
- Plugin install options
- Plugins and skills settings
- Settings files and who they affect
- Manage installed plugins
License
MIT (SPDX-License-Identifier: MIT).
Details
- Marketplace
- melodic-software/claude-code-plugins
- Source
- plugins/spelling
- Category
- Development
More from melodic-software/claude-code-plugins
All 139Similar to spelling
More Development Tools
reamorluto/rea466.8K starsReverse engineer anything with agents, from app behavior down to native binaries.
superpowersobra/superpowers319.5K starsCore skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
claude-apianthropics/skills196.9K starsClaude API and SDK documentation skill for building LLM-powered applications
prompts.chatf/prompts.chat178.2K starsAccess thousands of AI prompts and skills directly in your AI coding assistant. Search prompts, discover skills, save your own, and improve prompts with AI.
agent-sdk-devanthropics/claude-code156.1K starsDevelopment kit for working with the Claude Agent SDK
ui-ux-pro-maxnextlevelbuilder/ui-ux-pro-max-skill152.6K starsProfessional UI/UX design intelligence for AI coding assistants. Includes searchable databases of styles, colors, typography, charts, and UX guidelines for Reac
