Skip to content
Back to skills

Naming Conventions

ASecurity

Applies descriptive, self-documenting naming in any language (TypeScript, bash, workflow YAML, Dockerfiles). Use this skill whenever naming or renaming an identifier, variable, constant, function, parameter, env var, workflow job, or Dockerfile ARG/ENV, or reviewing names for vagueness, abbreviations, or redundant type noise.

  • 27 stars
  • 0 votes
  • 1 copy
  • 11 views
  • Added October 26, 2026
ai-agentstypescriptgoswiftbashreactdockerapi

Works with

  • cli
  • api

Security analysis

A100/100

Pro scans all 2 files and shows the line behind each finding

Scanned November 11, 2026

npx -y skills add gaia-harness/gaia --skill naming-conventions --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Naming Conventions?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Naming Conventions
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/gaia-harness-naming-conventions/badge)](https://www.skillsdirectory.com/skills/gaia-harness-naming-conventions)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: naming-conventions
description: Applies descriptive, self-documenting naming in any language (TypeScript, bash, workflow YAML, Dockerfiles). Use this skill whenever naming or renaming an identifier, variable, constant, function, parameter, env var, workflow job, or Dockerfile ARG/ENV, or reviewing names for vagueness, abbreviations, or redundant type noise.
---

# Naming Conventions

Follow Apple's Swift API Design Guidelines: names should be clear at the point of use, reading like prose. Favor long, descriptive names over short or abbreviated ones.

- **Functions and methods**: imperative verb phrases: `calculateProgressPercentageFromCompletedSets`, `processUserOnboardingProfile`
- **Parameters**: role, not type: `totalSeconds` not `n`, `emailAddress` not `s`
- **Variables**: what they hold: `restDurationInSeconds`, `submitButton`, `weightInputValue`
- **No abbreviations**: owned by `.claude/rules/no-abbreviations.md`
- **No type noise**: `availableExercises` not `exerciseArray`, and never so short it loses clarity

Casing is each language's own convention; for TypeScript, see `.claude/rules/typescript.md`.

> **Exception, React event handlers** follow `handle{Action}{Element}` from the react-code skill
> (e.g. `handleClickSave`, `handleChangeInput`), the `{Element}` is required, since a bare
> `handleClick` or `handleChange` says when it fires, not what it does. The descriptive
> naming guidelines above apply to utilities, hooks, callbacks, and non-event-handler functions.

Read `references/examples.md` for extended BAD/GOOD examples of each naming pattern.

Files in this skill

  • SKILL.md1.5 KB
  • references/examples.md1.8 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.