naming-precision

Enforce precise naming conventions for code identifiers in Python.

28|3|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/oborchers/fractional-cto --skill naming-precision
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: naming-precision
Source: https://github.com/oborchers/fractional-cto/tree/main/pedantic-coder/skills/naming-precision
Command: npx skills add https://github.com/oborchers/fractional-cto --skill naming-precision

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill addresses the common problem of unclear, vague, or misleading names in code, which leads to confusion, bugs, and increased maintenance effort.

Core Features & Use Cases

  • Semantic Accuracy: Ensures variable, function, and class names accurately reflect their purpose.
  • Scope-Aware Naming: Guides the use of short names in tight scopes and descriptive names in wider scopes.
  • Domain-Specific Language: Promotes the use of business terminology over programmer jargon.
  • Use Case: When naming a new function that calculates a user's discount percentage based on their purchase history, this Skill ensures it's named something like calculate_customer_discount_percentage instead of a vague process_data or get_value.

Quick Start

Use the naming-precision skill to review the names of all variables and functions in the provided Python code snippet.

Frequently Asked Questions about naming-precision

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

FAQPage Schema
How do I enforce descriptive naming conventions for variables and functions in my code?

Apply verb-noun patterns for functions and domain-aligned terminology to enforce precise naming conventions across all code identifiers. This ensures variables and functions accurately reflect their purpose, directly improving code readability and maintainability.

What is the best way to name a function that calculates business logic, like a user discount?

Name business logic functions using domain-specific language and verb-noun patterns. Name a discount calculation function `calculate_customer_discount_percentage` rather than vague terms like `process_data` to ensure semantic accuracy and alignment with business terminology.

How does scope-aware naming improve clean code readability?

Scope-aware naming improves clean code readability by guiding the use of short names in tight scopes and descriptive names in wider scopes. This approach matches identifier length to context, reducing confusion and bugs caused by vague references.

Why does using programmer jargon instead of domain-specific language lead to code maintenance issues?

Using programmer jargon instead of domain-specific language leads to maintenance issues because vague or misleading names obscure business intent. Promoting business terminology over generic programmer jargon ensures semantic accuracy and reduces confusion for future maintainers.

Can I use automated scripts to review code identifier names for semantic accuracy?

Yes, you can use scripts to review code identifier names for semantic accuracy. These scripts analyze variables, functions, classes, and files to ensure they adhere to verb-noun patterns and domain-aligned terminology, addressing semantic accuracy and scope-awareness.

What are the limitations of applying naming conventions during a large refactoring effort?

A limitation of applying naming conventions during refactoring is ensuring all scope-aware adjustments and domain-specific terminology updates remain consistent across wider scopes without introducing semantic inaccuracies or breaking existing business logic references.