Start with --diff or read-only mode before auto-fixes.
Keep project-specific allowlists narrow in .typos.toml.
Re-run after fixes to ensure clean output.
Common Pitfalls
Blind auto-fixes can modify intentional domain terms.
Broad ignore lists hide genuine mistakes.
Generated files may require explicit exclude rules.
Output Interpretation
Default output reports file:line:col and suggested correction.
JSON format can be parsed and summarized with jq.
Exit code 1 indicates typo findings were detected.
Why It Matters For Agents
Agent-generated code and docs benefit from a final spelling pass.
Fast runtime makes it practical to run on every commit.
Repo Conventions
Keep user-facing docs and strings typo-free.
Prefer fixing source terms over expanding ignore lists.
Trigger Examples
Should trigger: "Scan docs for misspelled command names."
Should trigger: "Run typo checks before opening this PR."
Should not trigger: "Query YAML values from a workflow file."
1---2name: tool-typos-23description: tool-typos4---5# tool-typos67## When To Use89- Detect typo regressions in source, docs, and identifiers.10- Run quick spelling checks before commits and releases.11- Produce machine-parseable typo reports for CI pipelines.1213## Trusted Commands1415```bash16typos17typos src/18typos --diff19typos --write-changes20typos --type py .21typos --format json22```2324## Safe Defaults2526- Start with `--diff` or read-only mode before auto-fixes.27- Keep project-specific allowlists narrow in `.typos.toml`.28- Re-run after fixes to ensure clean output.2930## Common Pitfalls3132- Blind auto-fixes can modify intentional domain terms.33- Broad ignore lists hide genuine mistakes.34- Generated files may require explicit exclude rules.3536## Output Interpretation3738- Default output reports `file:line:col` and suggested correction.39- JSON format can be parsed and summarized with jq.40- Exit code 1 indicates typo findings were detected.4142## Why It Matters For Agents4344- Agent-generated code and docs benefit from a final spelling pass.45- Fast runtime makes it practical to run on every commit.4647## Repo Conventions4849- Keep user-facing docs and strings typo-free.50- Prefer fixing source terms over expanding ignore lists.5152## Trigger Examples5354- Should trigger: "Scan docs for misspelled command names."55- Should trigger: "Run typo checks before opening this PR."56- Should not trigger: "Query YAML values from a workflow file."
Run npx skillmds@latest add niksavis/tool-typos-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
tool-typos It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
niksavis (@niksavis) published this skill. Their other Agent Skills are listed on their SkillMD profile.
niksavis