rolemodel-skills

Plugin rolemodel-skills in RoleModel/skills. Commands read from the repo's manifest — 2 days ago.

Skills (31)

• agentation

  Add Agentation visual feedback toolbar to a project. Use when the user asks to "install Agentation", "add the Agentation toolbar", or "set up visual feedback". Covers Rails apps that bundle with webpack into `app/assets/builds` (the RoleModel default) by adding React as a development-only dependency

• babysit-pr

  Shepherd an already-open pull request to a mergeable state — poll CI, triage review comments, verify each one against the source, push fixes, and keep the branch current. Use when the user asks to "babysit", "monitor", "watch", "shepherd", or "drive" a PR, asks you to "fix the CI on my PR", "handle

• bem-structure

  Expert guidance for writing, refactoring, and structuring CSS using BEM (Block Element Modifier) methodology. Provides proper CSS class naming conventions, component structure, and Optics design system integration for maintainable, scalable stylesheets.

• brave-breakdown

  Use this skill to guide a developer or designer through a BRAVE framework breakdown of a task before they start work. Trigger whenever someone wants to think through a ticket, break down a card, plan their approach before starting, validate a task before picking it up, or prepare a breakdown to shar

• cloudflare-tunnel

  Expose locally-running apps to stable public HTTPS URLs using a single per-developer Cloudflare Tunnel (cloudflared). Use whenever you need an external service to reach your local dev server — receiving webhooks (Box, Stripe, GitHub, Twilio, etc.), testing OAuth callbacks, sharing a work-in-progress

• create-pr

  Opens pull requests with a consistent description format and assignment. Use when the user asks to open, create, file, or draft a PR or pull request, push a branch for review, or write a PR description. author: rolemodelsoftware version: "2.0" triggers: "open a PR, create a PR, file a PR, draft a PR

• dependabot-stack

  Group all open Dependabot PRs on a repository into a single ordered stack using gh-stack. Run weekly, after Dependabot's batch of grouped-update PRs lands. Use when asked to stack, organize, or clean up Dependabot PRs.

• document-this

  Generate multi-audience documentation from any codebase — workflows for non-technical readers, architecture for developers, and AI orientation for agents. Deterministic JS scripts handle structural extraction; the agent writes the prose. Project-agnostic and self-orienting. Use when the user asks to

• dynamic-forms

  Build forms that change as they are filled in — cascading or dependent dropdowns, conditional fields and sections, option lists that depend on another field, STI type switches — with the turbo_form gem. Use when a form must update without a full page reload, when adding or changing a dynamic form, o

• feature-review

  Reviews a PR, commit, range, or branch as a feature first and code second, in a local HTML page whose comments post back to the PR as one GitHub review. Use when the user asks to review a PR or commit, review the feature or shape of a change, or re-review a PR after new pushes: "review PR #123", "re

• generate-conventions

  Interactively fill a project's docs/conventions/ by proposing candidate rules from taste calls, from the codebase, and from past PR review comments, then writing what's confirmed. author: rolemodel version: "1.1" triggers: "generate conventions, write conventions, document our conventions, mine revi

• made-it-wrong-retro

  Retro on a `make-it-right` run: finds where it missed a problem, kept a false alarm, made a bad fix, or skipped a step, proves each lesson with a failing replay at the lowest level that shows it, and proposes the edit to make-it-right. Also prunes rules that never fire. Use when the user says "made

• make-it-fast

  The optional "make it fast" pass after a change is right. Reviews it for speed and efficiency (database queries, request time, test suite speed, and page responsiveness), verifies each finding, fixes what it can measure, and reports before-and-after numbers. Use when the user says "make it fast", "s

• make-it-right

  The "make it right" pass after code works. Tests whether the change meets its requirements and reviews whether it is done correctly, verifies every finding against the source, fixes them, and reports what a human still needs to look at. Use when the user says "make it right", "review and fix", "clea

• optics-context

  Styles Rails views with RoleModel's Optics design system — its components, `--op-` design tokens, and theme overrides. Use when writing or reviewing CSS, styling a view or component, picking a color, spacing, font, radius, or shadow value, fixing hard-coded CSS values, adding a project token, or the

• polymorphic-parent-resources

  Serve a child resource that hangs off many different parents — comments, reports, duplications, attachments — from a single Rails controller, using a route concern plus `resource_for` from the rolemodel_rails gem. Use when a child resource needs to attach to several parent models, when about to writ

• rails-audit

  Perform comprehensive code audits of Ruby on Rails applications based on thoughtbot best practices. Use this skill when the user requests a code audit, code review, quality assessment, or analysis of a Rails application. The skill analyzes the entire codebase focusing on testing practices (RSpec), s

• rails-conventions

  RoleModel's Rails conventions where they differ from what an agent writes by default: flash wording, the status for failed saves, Simple Form for every form, how route concerns pass the parent type, and two gotchas (`params.expect` with nested attributes, and Lexxy rich-text change events). Use when

• rake-tasks

  Write Rake tasks in apps that use the rolemodel_rails gem with its `Rolemodel::Utility::TaskTools` mixin, for migration-style console output, a progress spinner, a `DRY_RUN` preview mode, and optional positional arguments. Use when writing or changing a rake task, data backfill, one-off data fix, cl

• rm-sentry-issue-fixer

  Find and fix issues from Sentry. Use when asked to fix Sentry errors, debug production issues, investigate exceptions, or resolve bugs reported in Sentry. Methodically analyzes stack traces, breadcrumbs, traces, and context to identify root causes.

• ruby-version

  Verify what Ruby versions actually exist and install a specific Ruby via rbenv. Use BEFORE asserting that any Ruby version does or doesn't exist (e.g., "Ruby 4.0 isn't out yet", "the latest Ruby is 3.x", "Ruby X.Y.Z doesn't exist"). Also use when the user asks "what's the latest Ruby", "is Ruby X ou

• scaffold-docs

  Install the RoleModel agent-documentation structure in a project: a minimal AGENTS.md, a docs/ tree with CONVENTIONS.md and INDEX.md, a path-scoped Copilot instructions file, the surface_conventions PreToolUse hook, and the wrap-up skill. author: rolemodel version: "1.0" triggers: "scaffold docs, se

• sentry-top-issue

  Pick the single highest-priority unresolved Sentry issue and hand it off to a fixer skill. Use when triaging Sentry errors, running automated issue triage, or when asked to fix the top Sentry issue in a project.

• soft-destroyable

  Soft-delete ActiveRecord models with the `SoftDestroyable` concern installed by the rolemodel_rails `rolemodel:soft_destroyable` generator, including cascading soft deletes and restores across associations. Use when making a model soft-deletable, deleting or restoring a soft-destroyable record, quer

• split-stack

  Split one PR that does too much into a stack of PRs, one per concern, without changing the combined diff. Use when asked to split, extract, carve out, or unbundle part of a PR into its own stacked PR.

• standup-prep

  Interview-style prep for a daily standup call. First asks which project or customer the standup is for and whether the person is leading that project today or just reporting their own work — a lead gets a second, separate cross-project pass across Linear, GitHub, Harvest, and Slack on top of their o

• tdd

  Test-driven development and testing patterns for Rails applications. Drives implementation from tests using an outside-in approach with RSpec, Capybara, and FactoryBot. Use when building new features, writing or improving tests, adding test coverage, fixing bugs with a test-first workflow, or when t

• trace

  Traces a piece of code to every place its flow starts and down to the data it touches, including calls made from inside installed packages. Use when the user says "trace X", "trace this", "what calls this", "where is this used", "how does this request flow", or "where does this data come from".

• turbo-modals

  Open forms and content in a modal or side panel using RoleModel's Turbo Frame modal pattern, as installed by the rolemodel_rails `rolemodel:turbo:modals` generator. Use when adding a modal or panel, linking to an action that should open in one, rendering a form inside one, or debugging a modal that

• ux-review

  Reviews UI code (Slim/HTML, CSS, Stimulus/JS) for usability problems against Nielsen's 10 usability heuristics and the Laws of UX, and reports them as a ranked issue log with evidence and fixes. Use when asked for a UX review, UI review, usability audit, heuristic evaluation, or "is this usable", wh

• wrap-up

  End-of-session skill that captures learnings into the right doc layer and updates project instructions.