CtrlK
BlogDocsLog inGet started
Tessl Logo

controller-patterns

Review and update existing Rails controllers and generate new controllers following professional patterns and best practices. Covers RESTful conventions, authorization patterns, proper error handling, and maintainable code organization.

64

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is highly actionable with copy-paste-ready Rails patterns and good single-file organization, but it carries some redundant examples and its bulk/generation workflows lack explicit validation checkpoints.

Suggestions

De-duplicate the CRUD controller: keep one full example (Complete Examples) and reference it from Quick Reference instead of reproducing it, tightening token use.

Add an explicit post-operation verification step to bulk workflows (e.g., re-query affected records or assert the expected count changed) and a validate/retry checkpoint in the generation steps to satisfy the batch-operation feedback-loop requirement.

Collapse the repeated per-action RESTful snippets in section 3 by pointing to the single canonical CRUD template, since the same index/show/new/create/edit/update/destroy patterns already appear verbatim elsewhere.

DimensionReasoningScore

Conciseness

The body is dense, reference-oriented, and assumes Claude's competence with no beginner-concept padding, but the full CRUD controller is shown twice (Quick Reference and Complete Examples) and RESTful action patterns repeat, so it could be tightened — matching the 'mostly efficient but could be tightened' anchor.

2 / 3

Actionability

Provides fully executable Ruby controller classes, complete strong-parameters examples with params.expect, policy_scope/authorize usage, routes, views, and a concrete before/after anti-pattern table — copy-paste ready.

3 / 3

Workflow Clarity

A decision tree and numbered generation steps with a review checklist provide a clear sequence, but bulk/destructive operations (update_all) and the generation steps lack explicit post-operation validation/verification checkpoints, capping workflow clarity at 2 per the batch-operation feedback-loop rule.

2 / 3

Progressive Disclosure

No bundle files exist and none are needed; the single file is well-organized with an at-a-glance overview and decision tree up front, followed by clearly headed sections (Essential Patterns, Complete Examples, Common Mistakes, Advanced Patterns, Agent Instructions) for easy navigation.

3 / 3

Total

10

/

12

Passed

Description

82%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific and well-scoped to Rails controllers with good natural trigger coverage, but it omits an explicit 'Use when...' clause so the trigger guidance is only implied rather than stated.

Suggestions

Add an explicit 'Use when...' clause to the description (e.g., 'Use when generating or reviewing Rails controllers, adding Pundit authorization, or implementing RESTful/nested/state-transition actions') so the trigger context is stated, not implied.

Surface a couple of the strongest natural trigger phrases ('rails controller', 'before_action', 'Pundit authorization') directly in the description prose rather than only in metadata.triggers.

DimensionReasoningScore

Specificity

Names multiple concrete actions — 'Review and update existing Rails controllers', 'generate new controllers', plus RESTful conventions, authorization patterns, error handling, and code organization — matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

It clearly answers 'what' (review/update/generate controllers, patterns covered) but the description field lacks an explicit 'Use when...' clause, so 'when' is only implied — capping completeness at 2 per the judging guideline.

2 / 3

Trigger Term Quality

The metadata triggers ('rails controller', 'generate controller', 'review controller', 'RESTful controller', 'before_action', 'controller callback') give good coverage of natural phrases a user would say, with relevant domain terms in the description prose.

3 / 3

Distinctiveness Conflict Risk

Scoped specifically to Rails controllers with RESTful/authorization/Pundit triggers, occupying a clear niche unlikely to conflict with non-Rails skills.

3 / 3

Total

11

/

12

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (641 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

Total

14

/

16

Passed

Repository
RoleModel/rolemodel-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.