refactor-lexical-ontology

Audit codebase identifiers for lexical-ontology misalignments and report findings.

6|1|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/JordanGunn/skills --skill refactor-lexical-ontology
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor-lexical-ontology
Source: https://github.com/JordanGunn/skills/tree/main/skills/refactor/lexical-ontology
Command: npx skills add https://github.com/JordanGunn/skills --skill refactor-lexical-ontology

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audit identifiers to ensure ontological correctness and reduce semantic drift across modules. It highlights agentive suffix misuse, category errors, and naming drift, then guides minimal, safe refactors.

Core Features & Use Cases

  • Lexical-ontology audit to verify naming semantics across the codebase.
  • Detect misalignments such as agent vs process vs artifact in identifiers.
  • Produce a concise Markdown report with findings and a minimal migration plan.
  • Use case: align a large repository where modules reuse ambiguous nouns and verbs.

Quick Start

Run the lexical-ontology audit on target code to produce a report with actionable fixes.

Frequently Asked Questions about refactor-lexical-ontology

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

FAQPage Schema
How do I audit my codebase for naming inconsistencies and semantic drift?

To audit naming inconsistencies, run an identifier audit that targets module namespaces, suffix morphology, and semantic roles to detect misalignments like agent vs process vs artifact. This produces a Markdown report with findings and a minimal migration plan.

What is lexical ontology misalignment in software identifiers?

Lexical ontology misalignment occurs when identifiers suffer from agentive suffix misuse, category errors, or naming drift across modules. Detecting these semantic issues ensures ontological correctness and reduces ambiguity in large repositories.

How do I refactor ambiguous nouns and verbs across a large repository?

Refactoring ambiguous nouns and verbs across a large repository requires auditing identifiers for semantic roles and category errors. The audit generates a concise Markdown report detailing recommended renames and a minimal, safe migration plan.

Does the lexical audit handle module namespaces and suffix morphology?

Yes, the lexical audit specifically handles module namespaces and suffix morphology. It evaluates semantic roles across the lexical-ontology domain to verify lexical correctness and identify agentive suffix misuse.

What is the best way to fix category errors in code naming without breaking dependencies?

Fixing category errors safely involves auditing identifiers for semantic misalignment and following a minimal migration plan. The generated report guides safe refactors to ensure ontological correctness while reducing semantic drift.