# Improve Code Naming Quality

Poor identifiers make code harder to review and maintain. This skill identifies naming issues and suggests clearer, convention-aware alternatives.

## Install

```bash
npx skillstore add softaworks/naming-analyzer
```

## Metadata

- Status: approved
- Slug: softaworks-naming-analyzer
- Skillstore revision: r1
- Version status: missing
- Tree hash: 54d42ab4c2798637eafe71c39b0727c3503d36cce0ec6c3cf0ba7565773d654e
- Author: softaworks
- GitHub username: softaworks
- License: MIT
- Repository: https://github.com/softaworks/agent-toolkit/tree/main/skills/naming-analyzer/
- Ref: f93e9bb0daca99badb6a7e574b97737155d57cb3
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, env\_access
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/softaworks-naming-analyzer
- Manifest: https://skillstore.pages.dev/api/skills/softaworks-naming-analyzer/manifest

## Capabilities

- Reviews variables, constants, functions, methods, classes, files, directories, database fields, and API endpoints.
- Identifies vague names, unclear abbreviations, misleading identifiers, and single-letter names outside loop contexts.
- Checks language conventions for JavaScript, TypeScript, Python, Java, Go, and similar languages.
- Classifies naming issues by impact and explains why each suggestion improves clarity.
- Suggests consistent boolean prefixes, constant names with units, and safer alternatives for misleading names.
- Can outline refactoring guidance for applying naming changes with IDE rename tools.

## Use Cases

- Review Pull Request Names: Find unclear identifiers in a changed file before approving a pull request.
- Standardize Project Conventions: Compare names across a codebase and create consistent patterns for booleans, constants, and services.
- Clean Up Legacy Code: Replace vague, abbreviated, or misleading names with clearer alternatives during refactoring.

## Prompt Templates

### Review One File

```
Analyze the naming in this file. List unclear identifiers, explain each issue, and suggest better names.
```

### Check Language Conventions

```
Review this code for naming conventions in [language]. Focus on variables, functions, classes, constants, and booleans.
```

### Prioritize Renaming Work

```
Analyze naming in [path]. Group findings by severity and provide a prioritized renaming plan with reasoning.
```

### Prepare Refactor Guidance

```
Review these naming suggestions and create a safe refactoring plan. Include validation steps and names that need domain confirmation.
```

## Limitations

- It relies on the code and context provided by the user or accessible workspace files.
- It may need domain guidance before choosing names for business-specific concepts.
- It does not guarantee behavior-preserving refactors without running project tests.
- It focuses on naming quality, not full architecture or security review.

## Best Practices

- Provide surrounding code so suggestions can reflect behavior and domain meaning.
- Review high-impact misleading names before broad style cleanup.
- Use IDE rename tools and tests when applying accepted suggestions.

## Anti Patterns

- Do not rename identifiers only to satisfy style when the current name carries important domain meaning.
- Do not apply broad rename scripts without reviewing generated changes.
- Do not mix language conventions inside one module unless the project already requires it.

## Security Audit

- Audited at: 2026-07-07T05:22:44.936\+00:00
- Summary: Reviewed all 82 static findings against SKILL.md and README.md. The reported command execution, environment access, sensitive file access, and reconnaissance signals are false positives caused by Markdown examples and inline code. No prompt injection, data exfiltration intent, or malicious behavior was found in the reviewed files.

## Stats

- Views: 332
- Downloads: 13
- Favorites: 0
- Popularity score: 0