naming-conventions

Enforce truthful naming conventions for files, functions, variables, and schema artifacts.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/jacob-balslev/skill-graph --skill naming-conventions-jacob-balslev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: naming-conventions
Source: https://github.com/jacob-balslev/skill-graph/tree/main/marketplace/skills/naming-conventions
Command: npx skills add https://github.com/jacob-balslev/skill-graph --skill naming-conventions-jacob-balslev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Naming conventions prevent misleading identifiers by enforcing casing, verb semantics, and cross-artifact consistency so codebase readers (and future maintainers) can trust what names imply.

Core Features & Use Cases

  • Identifier morphology guidance: choose verbs like get/fetch/validate/parse based on side effects, cost, and failure behavior.
  • Artifact-specific casing rules: apply kebab-case, camelCase, PascalCase, snake_case, and SCREAMING_SNAKE_CASE appropriately to files, paths, types, env vars, SQL columns, and constants.
  • Truthfulness and “names that lie” detection: identify common naming bugs such as boolean polarity inversion, getX functions that mutate, and stale meanings after refactors.
  • Rename coordination workflow: plan safe renames by finding all call sites, updating references in one commit, and choosing deprecation aliases when needed.
  • Scope boundaries: explicitly avoid using this skill for documentation writing, content prose, code restructuring, PR review, debugging, or scaffolding a naming-conventions-teaching skill.

Quick Start

Apply naming-conventions to decide the most truthful identifier name for a new route, function, variable, or database column, and then validate the choice against the skill’s verb and casing rules.

Frequently Asked Questions about naming-conventions

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

FAQPage Schema
How do I choose the right verb for naming functions based on side effects and cost?

Function naming verbs like get, fetch, validate, and parse should be chosen based on side effects, cost, and failure behavior to ensure identifier semantics truthfully reflect the operation. This prevents misleading names and improves codebase readability.

What are the correct casing rules for naming files, types, and database columns?

Artifact-specific casing rules apply kebab-case to files and paths, camelCase to variables, PascalCase to types, SCREAMING_SNAKE_CASE to constants, and snake_case to SQL columns. Applying the correct casing consistently helps readers trust what names imply across the codebase.

How do I identify "names that lie" in my codebase during a refactor?

Detecting names that lie involves identifying common naming bugs like boolean polarity inversion, getX functions that mutate state, and stale meanings left after refactors. Truthful naming requires validating identifiers against their actual behavior and downstream dependencies.

What is the best way to plan a safe rename for a function or variable across a codebase?

Safe rename coordination requires finding all call sites, updating references in a single commit, and choosing deprecation aliases when needed. This workflow prevents broken downstream dependencies and ensures behavior interpretation remains intact across the refactor.

Can I use naming conventions for writing documentation or restructuring my code?

Naming conventions are explicitly scoped to enforce truthful, consistent naming for files, functions, variables, types, routes, and data or schema artifacts. This skill avoids documentation writing, content prose, code restructuring, PR review, and debugging.