A personal collection of utility tools for Ruby on Rails development. The primary file is tools.rb, which defines Ellis::Tools — a module you load into a Rails console to inspect models, trace relationships, annotate schemas, and more.
# Load in any Rails console
load ‘/path/to/tools.rb’Generate detailed schema annotations including columns, types, defaults, nullability, validations, indexes, and check constraints.
# Annotate a model — prints to console and copies to clipboard
Ellis::Tools.annotate(User)
# Write the annotation directly to the model file
Ellis::Tools.annotate(User, to_file: true)Model options (defaults: to_clipboard: true, to_screen: true, to_file: false):
:to_clipboard— Copy the output to the clipboard:to_screen— Display the output in the console:to_file— Append the annotation to the model source file
Inserts route comments directly above each action method in the controller source file.
# Annotates the controller file with route comments above each action
Ellis::Tools.annotate(EvaluationsController)
# Example result in the controller file:
# [GET] /evaluations
def index
# [PUT/PATCH] /evaluations/:id
def updateControllers default to to_file: true and to_clipboard: false. Multiple HTTP verbs for the same action are combined. Re-running safely replaces existing route comments.
Find all ActiveRecord association paths between two models via breadth-first search.
Ellis::Tools.relations(User, Organization)
# => [
# "User belongs_to :current_organization -> Organization",
# "User has_many :organization_users -> OrganizationUser belongs_to :organization -> Organization"
# ]
# Options: max_depth (default: 10), verbose: true, max_steps: 100_000List all models that reference a given model through associations.
Ellis::Tools.dependents(Patient)
# => 🔗 Evaluation has_many :patients → Patient [dependent: :destroy]
# ...Returns a detailed hash of all validations on a model’s fields.
Ellis::Tools.required(Evaluation)
# => {
# "date" => "presence",
# "patient_id" => "presence (association: :patient)",
# "title" => ["presence", "length(minimum: 2, maximum: 255)"],
# "amount" => "numericality(greater_than_or_equal_to: 0) — if: :billable?"
# }
# Include database-level NOT NULL constraints:
Ellis::Tools.required(Evaluation, validators_only: false)Compare two ActiveRecord objects and highlight attribute differences.
Ellis::Tools.diff_objects(user1, user2, ignore_keys: [:updated_at, :id])
# => { "email" => ["old@example.com", "new@example.com"], "name" => ["John", "Johnny"] }Compare execution times of methods.
Ellis::Tools.bench :old_method, :new_method, 500 # 500 iterations (default: 250)Extract model data as hashes.
Ellis::Tools.get_data_hash(User, to_clipboard: true, limit: 100)Copy any value to the macOS clipboard.
Ellis::Tools.clipboard(some_value)Stream-based find/replace for large files, designed for rewriting pg dumps for local development.
# Generic file rewrite
Ellis::Tools.rewrite_file("/path/to/dump.sql", replacements: { "old_role" => "new_role" })
# Preset rewrite for Ambiki dumps
Ellis::Tools.rewrite_ambiki_pg_dump("/path/to/dump.sql")skills/ holds personal Claude Code skills. Each folder is one skill: copy or symlink it into ~/.claude/skills/ and it becomes a slash command.
ln -s /path/to/tools/skills/eod ~/.claude/skills/eod| Skill | What it does |
|---|---|
/address |
Works through the review comments on a GitHub PR one at a time: fix it, push back, write a spec, or ask. One commit per comment, with replies held until the push is approved. |
/close-merged |
Deletes local branches whose PRs have merged, then reports PR state and unanswered review comments for the branches that remain. |
/eod |
Builds a paste-ready end-of-day report from the day's GitHub activity across the Ambiki org, plus any extra activities passed in. |
/research |
Deep-dives an Asana ticket: related tickets, the root cause in the code, and a few ways to fix it. |
/screenshots |
Screenshots a PR's visible changes in headless Chrome on test data, annotates each image, and publishes them on one claude.ai page with copy buttons. |
Most of these were written around Ambiki's Rails app and GitHub workflow, so paths, repo names and commands may need adjusting elsewhere.