CtrlK
BlogDocsLog inGet started
Tessl Logo

ruby

Use when writing, reviewing, or debugging pure Ruby code — idiomatic patterns, modern 3.x+ features (pattern matching, Data.define, endless methods), error handling conventions (raise vs fail, result objects), memoization, and performance idioms. For Rails use rails-guides. For testing use minitest. For code style use sandi-metz-rules.

77

Quality

96%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

92%

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

This is a high-quality Ruby skill that focuses on opinionated, non-obvious conventions that genuinely add value beyond Claude's default knowledge. The code examples are executable and well-chosen, covering error handling, modern Ruby features, performance idioms, and method ordering with clear good/bad contrasts. The only notable weakness is that referenced bundle files aren't provided, making it impossible to verify the progressive disclosure chain, and some inline content (particularly method ordering) could be more aggressively offloaded to references.

DimensionReasoningScore

Conciseness

The content is lean and efficient throughout. It avoids explaining what Ruby is or how basic concepts work, instead focusing on specific conventions and patterns that Claude might not default to (Weirich raise/fail, nil-safe memoization, breadth-first method ordering). Every section earns its place with concrete, non-obvious guidance.

3 / 3

Actionability

Every pattern is illustrated with executable, copy-paste-ready Ruby code. The Result object class is fully defined, pattern matching examples are complete, and the common mistakes table provides specific fixes. No pseudocode or vague instructions.

3 / 3

Workflow Clarity

This is primarily a conventions/idioms skill rather than a multi-step workflow skill. The single-task patterns are unambiguous, the method ordering section provides clear sequencing rules with good/bad examples, and the common mistakes table serves as a validation checklist. Per scoring notes, simple skills can score 3 if clear.

3 / 3

Progressive Disclosure

The skill has good structure with clear section headers and references to five separate reference files for deeper content. However, no bundle files were provided, so the referenced files (references/modern_ruby.md, references/error_handling.md, etc.) cannot be verified to exist. The inline content is well-organized but the method ordering section is somewhat lengthy and could potentially be offloaded to its reference file.

2 / 3

Total

11

/

12

Passed

Description

100%

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

This is an excellent skill description that clearly defines its scope (pure Ruby code), lists specific capabilities and features, provides explicit trigger guidance with 'Use when...', and proactively distinguishes itself from related skills by naming them. The boundary-setting with cross-references to rails-guides, minitest, and sandi-metz-rules is particularly effective for disambiguation in a multi-skill environment.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and capabilities: writing/reviewing/debugging Ruby code, pattern matching, Data.define, endless methods, error handling conventions (raise vs fail, result objects), memoization, and performance idioms.

3 / 3

Completeness

Explicitly answers both 'what' (idiomatic Ruby patterns, modern features, error handling, memoization, performance idioms) and 'when' ('Use when writing, reviewing, or debugging pure Ruby code'). Also provides clear boundary guidance by directing to other skills for Rails, testing, and code style.

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'Ruby code', 'pattern matching', 'error handling', 'memoization', 'performance', 'idiomatic', 'debugging'. Also includes version-specific terms like '3.x+' and concrete features like 'Data.define' and 'endless methods'.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with explicit boundary-setting: 'For Rails use rails-guides. For testing use minitest. For code style use sandi-metz-rules.' This proactively prevents conflicts with adjacent skills and carves out a clear niche for pure Ruby code.

3 / 3

Total

12

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
lucianghinda/superpowers-ruby
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.