Skip to content
cccskills
FreePublished on GitHub

naming-surface-audit

Audit and improve stable names, aliases, vocabulary, field casing, routes, ports, packages, and agent-search discoverability.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md1.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

naming-surface-audit

Improve naming quality across public and stable surfaces.

Procedure

  1. Read the naming guide, naming ADR, and decision-map rows for the affected surface.
  2. Inventory names across code, docs, tests, CLI help, schemas, events, tables, package manifests, ports, env vars, and generated registries.
  3. Check casing rules: JSON/API/YAML/framework fields use camelCase; CLI flags use kebab-case; SQL/collections use snake_case; events use domain.action.
  4. Identify stale synonyms, ambiguous abbreviations, legacy names, or names that agents cannot search naturally.
  5. Prefer explicit aliases and migration notes over silent renames when the surface is public.
  6. Add or update guards when a naming rule should stay frozen.

Constraints

  • Do not rename a public surface without a migration or explicit pre-public removal decision.
  • Do not introduce project-private brands, bundle ids, local paths, or maintainer names.
  • Names must be human-meaningful and agent-discoverable.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Govern Clawix accessibility changes across screen reader behavior, keyboard navigation, focus order, contrast, reduced motion, text scaling, timed interactions, and agent-generated UI.

The English summary is being prepared. Showing the original description.

clawic/Clawix8Updated Jun 6, 2026

Review or update stable, canonical, any-human, PMF, and adoption claims using adoption/canonicity governance packets.

The English summary is being prepared. Showing the original description.

clawic/Clawix8Updated Jun 6, 2026

Turn a new or changed ADR into implemented behavior, routing docs, tests, and guardrails rather than leaving it as standalone prose.

The English summary is being prepared. Showing the original description.

clawic/Clawix8Updated Jun 6, 2026

Repair confirmed architecture drift in small batches while preserving public canon and avoiding broad opportunistic refactors.

The English summary is being prepared. Showing the original description.

clawic/Clawix8Updated Jun 6, 2026

Given an existing Style, generate a human-readable brand guidelines document covering colors, typography, voice, do/don't, imagery rules, and usage examples. Use when the user asks for a brand book, brand guide, or design system document.

The English summary is being prepared. Showing the original description.

clawic/Clawix8Updated Jun 6, 2026

Add or improve canonical data catalog collections, fields, aliases, relations, evidence tags, docs, and tests.

The English summary is being prepared. Showing the original description.

clawic/Clawix8Updated Jun 6, 2026

See all skills by clawic

Report a problem with this skill