Skip to content
T1KTheOneKit

naming-convention

Naming Convention — Universal t1k- Prefix

Section titled “Naming Convention — Universal t1k- Prefix”

MANDATORY for every skill and agent shipped by any TheOneKit kit. No exemptions. A non-prefixed kit-shipped skill or agent is a bug — file /t1k:issue against the owning kit (do NOT silently rename in a consumer).

Rule

Section titled “Rule”

Every skill and agent shipped by a TheOneKit kit MUST start with t1k. This applies to filenames under .claude/agents/*.md and .claude/skills/*/SKILL.md, the name: field in frontmatter, and anything surfacing in Claude Code’s UI or registry routing.

  • Filenames under .claude/agents/*.md and .claude/skills/*/SKILL.md
  • The name: field in agent/skill frontmatter
  • Anything that surfaces in Claude Code’s agent dropdown, slash-command UI, or registry routing

Skills carry two forms (dash on disk: t1k-designer-base-balance-tools/; colon in frontmatter: t1k:designer:base:balance-tools) — same slug after -↔: conversion. Agents carry a single dash form everywhere — name: MUST equal basename byte-identically.

Slug structure by tier: core t1k-{slug}; kit-wide t1k-{kit}-{slug}; module-scoped t1k-{kit}-{module}-{slug}. {kit} = repo slug minus theonekit-. Slug MUST NOT redundantly start with {kit-short}- or any {module}-segment-token (algorithm v2 strips them).

Full details

Section titled “Full details”

Full reference (two-form table, single-form table, tier matrix, enforcement gates, violation handling, consumer-side zombie cleanup, authoring procedure): docs/naming-convention.md.

Authoring step-by-step: skills/t1k-skill-creator/references/architecture-rules.md § 0 (skills), skills/t1k-agent-creator/references/architecture-rules.md § 0 (agents).