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.
100
100%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
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 modern features, provides explicit trigger guidance with 'Use when...', and proactively delineates boundaries with related skills. The cross-references to other skills for Rails, testing, and code style are particularly effective at reducing conflict risk.
| Dimension | Reasoning | Score |
|---|---|---|
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'. Also includes version-specific terms like '3.x+' and concrete features like 'Data.define' and 'endless methods' that Ruby developers would reference. | 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 |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent skill file that focuses precisely on what Claude would miss by default — opinionated Ruby conventions, non-obvious gotchas, and modern 3.x+ features. The content is highly concise, fully actionable with executable examples, well-organized with appropriate progressive disclosure to reference files, and covers the right level of detail for an overview skill. The common mistakes table is a particularly effective addition.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient throughout. It assumes Claude knows Ruby basics and focuses exclusively on non-obvious conventions (Weirich raise/fail, nil-safe memoization, result objects) that an agent would likely miss. Every section earns its place with no padding or concept explanations. | 3 / 3 |
Actionability | Every pattern is demonstrated with executable, copy-paste-ready Ruby code. The examples are concrete and complete — from Result objects to pattern matching to memoization patterns. The common mistakes table provides specific fixes paired with specific anti-patterns. | 3 / 3 |
Workflow Clarity | This is primarily a conventions/idioms skill rather than a multi-step workflow skill. For its purpose, the organization is clear and unambiguous — each section covers a distinct concern with concrete guidance. Guard clauses, error handling patterns, and performance idioms each have clear sequencing where relevant (e.g., the error handling example shows fail → rescue → raise flow). | 3 / 3 |
Progressive Disclosure | The skill provides a well-structured overview with clear one-level-deep references to four separate reference files for advanced topics (modern_ruby.md, error_handling.md, performance.md, ood-philosophy.md). References are contextually placed at the end of relevant sections and also collected in a final References section. | 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- lucianghinda/superpowers-ruby
- Commit
cb03f92
- 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.