topline-code-skills

Topline Code Skills

Internal AI coding skill bundle for the Topline team. Wraps 20 skills covering Rails, Ruby, Tailwind, Hotwire, Cloudflare, and meta-level coding guidelines. Works with Claude Code, OpenAI Codex, Cursor, and Conductor.

Install — Claude Code

From inside Claude Code, run:

/plugin marketplace add Topline-com/code-skills
/plugin install topline-code-skills@topline-code-skills

You'll need read access to the Topline-com GitHub org for the marketplace fetch to succeed. If gh auth is already configured for your Topline-com membership, it just works. To update later, run /plugin marketplace update topline-code-skills and reinstall.

Install — OpenAI Codex

Codex doesn't have a marketplace concept, so install via clone + symlink. From a terminal:

git clone [email protected]:Topline-com/code-skills.git ~/code-skills
cd ~/code-skills
./install.sh codex          # symlinks into ~/.codex/skills/
cp AGENTS.md ~/.codex/AGENTS.md   # optional: global Codex guidance

To update later: cd ~/code-skills && git pull — symlinks resolve to the updated content automatically.

Install — both ecosystems on one machine

git clone [email protected]:Topline-com/code-skills.git ~/code-skills
cd ~/code-skills
./install.sh both

Install — into a Topline project repo

Drops CLAUDE.md, AGENTS.md, and .cursorrules into a project's root so every teammate working on that repo — regardless of which AI tool they use — gets the karpathy guidelines + skill pairings + Topline overrides.

cd ~/code-skills
./install.sh project /path/to/topline-project
# or, from inside the project itself:
~/code-skills/install.sh project

What ends up where:

File	Used by
CLAUDE.md	Claude Code, Conductor (conductor.build, runs Claude Code under the hood)
AGENTS.md	OpenAI Codex, plus any agent tool that follows the AGENTS.md convention
.cursorrules	Cursor IDE

All three files carry the same content — same overrides, same karpathy principles, same skill pairings. Pick whichever your tool reads; if a teammate uses multiple tools (Cursor + Claude Code, etc.), having all three in the project means everyone sees the same rules.

The script copies the files (so each project can customize) and skips any file that already exists — it never overwrites. Commit the resulting files to share the guidance with the team. Append project-specific rules below the karpathy section as needed.

Tool notes

• Claude Code auto-loads CLAUDE.md from the project root and any parent directory.
• Conductor (conductor.build) spawns Claude Code instances in parallel git worktrees — it inherits whatever CLAUDE.md is in the project, so no extra setup needed beyond the standard install.
• OpenAI Codex auto-loads AGENTS.md from the project root.
• Cursor auto-loads .cursorrules from the project root. (Cursor's newer per-rule .cursor/rules/*.mdc format is also supported but not used here — the single-file approach mirrors what the other tools expect.)

What's included

Coding meta-rules

• karpathy-guidelines — think before coding, simplicity first, surgical changes, goal-driven execution. Cross-references the stack skills below.

Rails (server-side)

• rails-dev — controllers, ActiveRecord queries, caching, migrations, background jobs, API design
• rails-testing — RSpec specs, factories, request/system tests, Sidekiq job tests
• 37signals-rails — DHH/Basecamp conventions: vanilla Rails, CRUD, no service objects, Solid Queue/Cache/Cable

Rails (UI / Hotwire)

• rails-hotwire — Turbo Drive/Frames/Streams, morphing, Stimulus controllers, broadcasts
• rails-design-system — partials, ViewComponent/Phlex, design tokens, form builders, helpers
• rails-application-ui-blocks — composing premium UI blocks from templates/application-ui into ERB views

Ruby (language-level)

• ruby-optimise — allocation, collection processing, ActiveRecord performance, string handling, concurrency
• ruby-refactor — code smells, method extraction, conditional simplification, design patterns

Tailwind CSS

• tailwind-refactor — v3 → v4 migration, deprecated utilities, @apply removal, class consolidation
• tailwind-ui-refactor — visual hierarchy, spacing, typography, color, depth, polish
• tailwind-responsive-ui — breakpoint strategy, fluid typography, mobile/touch patterns