scan-vocabulary

Scans a codebase for leftover references to retired terms using a parallel worker_threads scanner.

1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/CoderCoco-Studios/Hyveon --skill scan-vocabulary-codercoco-studios
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scan-vocabulary
Source: https://github.com/CoderCoco-Studios/Hyveon/tree/main/.claude/skills/scan-vocabulary
Command: npx skills add https://github.com/CoderCoco-Studios/Hyveon --skill scan-vocabulary-codercoco-studios

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Renames and removals often leave stray references behind, and self-reported "we got everything" claims are unreliable. This Skill provides a deterministic, repeatable sweep that verifies whether old class names, retired tooling vocabulary, deprecated env vars, or renamed fields actually disappeared from every file. ## Core Features & Use Cases - Parallel deterministic scanning: A dependency-free Node script uses worker_threads to scan every non-binary file across CPU cores, producing identical sorted output (file, line, column) on every rerun. - Boundary matching for short terms: The --boundary flag applies word-boundary matching plus a PascalCase segment variant, so a term like id catches IdToken without matching inside hidden. - Sensible exclusions: Skips build output, lockfiles, worktrees, and binary assets by default, with per-run --exclude paths for directories expected to cite retired names. - Use Case: After renaming a service class across a monorepo, run the scanner with the old name to confirm zero remaining references before calling the cleanup complete. ## Quick Start Ask the AI to run the scan-vocabulary script against the repo root with your retired terms, for example to verify that every reference to an old service name has been removed.

Frequently Asked Questions about scan-vocabulary

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify a code rename reached every file in a repo?

Run the scan-vocabulary script with the old name as a search term against the repo root. It scans every non-binary file and reports each remaining match with file, line, and column, so a clean rerun confirms the rename is complete.

How to search a codebase for short terms without false positives?

Use the --boundary flag for short or generic terms like "id". It applies word-boundary matching to avoid hits inside unrelated words like "hidden", and adds a PascalCase segment pattern that still catches identifiers such as getIdToken.

Does the scanner require any npm dependencies?

No, the script uses only Node.js built-in modules including worker_threads, fs, path, and os. It runs directly with any modern Node runtime without installing packages.

Why does grep give different results than this scanner?

Ad hoc grep output depends on flags and ordering, while this scanner sorts results deterministically by file, line, and column and excludes lockfiles, build output, and worktrees by default. Reruns against an unchanged tree always produce identical reports.

Can I exclude directories that legitimately reference old names?

Yes, pass --exclude with comma-separated paths relative to the scan root to skip directories for that run only, such as archived spec docs that cite retired terms. Permanent defaults live as editable constants at the top of the script.