Agent Skill
2/7/2026

naming

MANDATORY for all naming decisions - variables, functions, files, folders, classes, database tables, routes, CSS classes. Must be followed when creating or renaming any identifier. Non-negotiable baseline for consistent, readable names across all languages and contexts.

H
heyjordanparker
5GitHub Stars
1Views
npx skills add heyJordanParker/dotfiles

SKILL.md

Namenaming
DescriptionMANDATORY for all naming decisions - variables, functions, files, folders, classes, database tables, routes, CSS classes. Must be followed when creating or renaming any identifier. Non-negotiable baseline for consistent, readable names across all languages and contexts.

Talent Tree

Overpowered Claude Code talents to power level your software architecture.

Install Talents

Requires Claude Code.

/plugin marketplace add heyJordanParker/dotfiles
/plugin install talents@talent-tree

Talents

Invoked as /talents:<name>:

  • agent-browser — Automate browser interactions, web testing, screenshots, data extraction (requires agent-browser)
  • architecture — Present architectural options with tradeoffs
  • breadboarding — Map workflows into affordance tables
  • breadboard-review — Find design smells in breadboards
  • cc — Work with Claude Code skills, hooks, settings
  • codebase-exploration — Explore codebase structure and dependencies
  • commit-message — Structured commits with type prefix and file tree
  • debug — Systematic debugging with root cause tracing
  • design — UI components, styling, and interaction decisions
  • diagram — Generate Excalidraw diagrams on a live canvas (requires drawbridge)
  • naming — Consistent naming for variables, files, classes, everything
  • debate — N independent architects debate architectural options through structured rounds with cross-pollination
  • execute-plan — Orchestrate implementation plans with persistent team, validation gates per slice
  • independent-review — N identical parallel agents for consensus through redundancy
  • ledger — Review and update Claude.md files for template compliance
  • modeling — Transform shaped parts into concrete models (DB schema, UX flows, architecture)
  • pcc — Add pros/cons/confidence to any prompt
  • personas — 5 parallel persona agents for diverse perspectives
  • plan — Plan features using structured format
  • pragmatic-engineering — KISS-driven planning and review
  • review-plan — Review planning artifacts with 5 parallel specialized agents
  • review — Parallel code reviewers on uncommitted changes
  • shaping — Collaborate on problem definition and solution options
  • show-architecture — Annotated file trees inline
  • slicing — Break modeled features into vertical implementation slices with acceptance criteria
  • subagents — Framework for dispatching and managing subagents
  • trace — Code intelligence CLI: search, callers, definitions, complexity, file/method reads with rich architectural context (requires the bundled trace binary; see Tracer Setup below)
  • user-testing — Trace real user flows through code changes, find gaps
  • using-git-worktrees — Isolated git worktrees for feature work
  • verification-before-completion — Evidence before assertions
  • working-with-markdown-files — Rules for markdown editing
  • writing-tests — Behavior-driven tests, not implementation tests

Commands

Also invoked as /talents:<name>:

  • ask — Break complex scenarios into decision questions with 4+ options
  • brainstorm — Interactive design refinement using Socratic method
  • bug-hunt — Review code for bugs, logic errors, security vulnerabilities
  • commit — Validated commit with tests and comprehensive review
  • docs-review — Review Claude documentation with parallel subagents
  • pcc — Add pros/cons/confidence to any prompt
  • plan — Plan a feature using structured format
  • q — Answer questions only, no actions
  • retro — Analyze conversation history for patterns and improvements
  • wtf — Hard reset, redo the last task correctly

Hooks

The plugin includes hooks that run automatically to keep Claude disciplined:

  • session-start — Injects ground rules (no sycophancy, literal execution, read before acting)
  • retro-reminder — Nudges to run /retro if 3+ days since last one
  • block-git-revert — Blocks git reset, git restore, git checkout -- <file>. Forces manual execution.
  • block-unsafe-delete — Whitelists rm to specific directories only. Everything else blocked.
  • enrich-on-read — Auto-enriches every native Read/Glob with tracer's per-file lifecycle, complexity rank, and architecture-graph counts. Silent fallback if trace isn't installed; the native tool always runs.
  • pre-edit — "Did you read this file?" checklist before any edit
  • ask-user-question — Enforces research-first, 4+ options, self-contained questions
  • sync-shaping — Ripple-check reminders when editing shaping documents
  • user-prompt-submit — Pre-response checklist (read the code, question vs instruction, test your changes)

Tracer Setup

The enrich-on-read hook and the /trace skill both need the trace binary. The plugin ships a POSIX launcher that lands on PATH automatically when the plugin is enabled. tracer is a native Rust binary, so the launcher resolves a host-appropriate one: a committed prebuilt (macOS arm64 / Linux x86_64), a previously locally-built cached binary, or — on any other platform — cargo build from the crate source shipped in the plugin. If no Rust toolchain is present for that last path, trace prints an actionable "install Rust" error; the SessionStart primer degrades silently so sessions never break.

All 23 commands work from whichever binary the launcher resolves — there is no reduced-feature tier. If you want trace outside the plugin too, build it from tools/tracer and put it on PATH (the dotfiles setup.sh does this into ~/.local/bin):

cd tools/tracer
cargo build --release
install -m 755 target/release/trace ~/.local/bin/trace

Tracer wraps five external binaries: ast-grep, scc, universal-ctags, ripgrep, git. Install whichever your platform needs:

macOS (Homebrew):

brew install ast-grep scc universal-ctags ripgrep
xcode-select --install     # git

Linux (Debian/Ubuntu):

apt install universal-ctags ripgrep git
# ast-grep:  https://ast-grep.github.io/guide/quick-start.html
# scc:       https://github.com/boyter/scc#installation

Windows (Scoop):

scoop install ast-grep scc ripgrep
# universal-ctags: https://github.com/universal-ctags/ctags
# git:             https://git-scm.com/download/win

Verify with trace doctor — it lists missing binaries with the same install command for your platform. The enrich-on-read hook degrades gracefully: if trace isn't installed at all, the hook exits 0 with no output and native Read/Glob run normally — nothing breaks, you just don't get the enrichment.

Agents

Per Claude Code plugin schema, agents (.md files in packages/claude/agents/) are NOT distributed by the marketplace install — only skills, commands, and hooks. To use the bundled agents (explorer, researcher, architect, debugger, etc.), copy the files you want into your own ~/.claude/agents/ or <repo>/.claude/agents/:

git clone https://github.com/heyJordanParker/dotfiles.git /tmp/dotfiles
cp /tmp/dotfiles/packages/claude/agents/explorer.md ~/.claude/agents/
cp /tmp/dotfiles/packages/claude/agents/researcher.md ~/.claude/agents/
# ... and any others you want

The split worth knowing:

  • explorer — in-codebase architectural mapping ("where is X used", "how does Y work end-to-end"). Uses the trace skill heavily.
  • researcher — external research (library docs, APIs, framework references, web lookups). Uses agent-browser, cc, claude-api, plus trace for incidental in-repo grounding.
  • architect / backend-engineer / code-reviewer / debugger / frontend-engineer / regression-reviewer / tester — also have the trace skill for navigating the codebase during their work.

Safe Delete

Claude loves running rm -rf. Protect yourself by replacing rm with trash so deleted files go to macOS Trash instead of being permanently destroyed:

brew install trash

Then alias rm to trash in your shell profile:

cat >> ~/.zshenv << 'EOF'
# Safe delete - moves to Trash instead of permanent deletion
rm() {
  local args=()
  for arg in "$@"; do
    [[ "$arg" =~ ^-[rRfidv]+$ ]] && continue
    args+=("$arg")
  done
  trash "${args[@]}"
}
EOF

This silently strips rm flags (-rf, -i, etc.) and sends files to Trash. Claude thinks it's deleting; you can undo from Trash.


Dotfiles

macOS dotfiles managed with GNU Stow.

New Machine Setup

One-line bootstrap (clones to ~/dotfiles, then runs setup):

curl -fsSL https://raw.githubusercontent.com/heyJordanParker/dotfiles/master/setup.sh | bash

To clone elsewhere, do it yourself first; setup will run from whichever path you pick:

git clone https://github.com/heyJordanParker/dotfiles.git <path>
cd <path> && ./setup.sh

Either way installs Xcode CLI tools, Homebrew, all packages from Brewfile, bun, and symlinks configs.

Manual Usage

Each subdirectory of packages/ is a stow package. Its contents are exactly what should land at the package's stow target — no inner mirror wrappers. The package-to-target mapping lives in setup.sh.

# Add a new config — example: 'newapp' targets ~/.config/newapp/
cd <repo>/packages
mkdir -p newapp
mv ~/.config/newapp/* newapp/
stow -t ~/.config/newapp newapp

# Remove symlinks
stow -D -t ~/.config/newapp newapp

# Re-link after changes
stow -R -t ~/.config/newapp newapp

Structure

Stow packages live under dotfiles/packages/<pkg>/. Each package contains the actual files that get symlinked to its target — see Claude.md for the full architecture.

Skills Info
Original Name:namingAuthor:heyjordanparker