# Refactor Lexical Ontology

> Audit identifiers and namespaces for lexical-semantic and ontological correctness. Detect semantic role misalignment (agent/tool/process/artifact), derivational misuse (e.g., -er agent nouns), and category errors between modules, packages, classes, functions, and data artifacts. Output a single Markdown report with actionable fixes.

- Skill: `majiayu000/refactor-lexical-ontology` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/refactor-lexical-ontology`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/refactor-lexical-ontology/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/refactor-lexical-ontology

---


# Instructions

Read all references in `references/` before using this skill.

## Signals

- The user says: "naming feels off", "planner vs planning", "module naming convention",
  "agentive suffix misuse", "semantic role mismatch", "ontology drift", "lexical audit"
- A naming refactor is planned or ongoing
- Confusion exists between *thing* vs *doer* vs *process* vs *tool* in identifiers
- The codebase has inconsistent conventions between directories/modules/classes/functions

## References

**Directory:** `references/`

- `01_INTENT.md`
- `02_PRECONDITIONS.md`
- `03_RULES.md`
- `04_PROCEDURE.md`
- `05_OUTPUT.md`

## Scripts

If scripts are present, also read `scripts/INDEX.md` and follow any automated steps first.