CtrlK
BlogDocsLog inGet started
Tessl Logo

ruby-commit-message

Use when committing code changes in Ruby or Ruby on Rails projects — guides commit message structure, type selection, and body content following Conventional Commits format

76

Quality

95%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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 skill that efficiently communicates commit message conventions for Ruby/Rails projects. It's well-structured with a clear format template, actionable rules, diverse examples, and a useful common mistakes table. The content respects Claude's intelligence while providing the specific conventions and examples needed to produce correct output.

DimensionReasoningScore

Conciseness

The content is lean and well-structured. The type table, rules, and examples all earn their place. There's no unnecessary explanation of what commits are or how git works — it assumes Claude's competence and focuses on the specific conventions.

3 / 3

Actionability

Provides a concrete format template, specific rules (imperative mood, 70 char limit, 72 char wrap), complete examples covering multiple scenarios (security fix, new feature, breaking change), and a common mistakes table with fixes. Fully actionable without ambiguity.

3 / 3

Workflow Clarity

For a single-task skill (writing commit messages), the workflow is unambiguous: format template → subject rules → body guidelines → footer conventions. The sequential structure naturally guides the process, and the common mistakes table serves as a validation checklist.

3 / 3

Progressive Disclosure

For a self-contained skill under 100 lines with no need for external references, the content is well-organized with clear sections (format, types, subject rules, body guidelines, footer, examples, common mistakes). No bundle files are needed and none are referenced unnecessarily.

3 / 3

Total

12

/

12

Passed

Description

89%

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 a solid description that clearly communicates both when to use the skill and what it does, with good trigger terms for Ruby/Rails commit workflows. The main weakness is that the specificity of capabilities could be stronger — it describes guidance areas rather than listing concrete discrete actions. Overall it performs well for skill selection purposes.

Suggestions

List more concrete actions to improve specificity, e.g., 'Generates conventional commit messages with proper type prefixes (feat, fix, refactor), scoped to Ruby/Rails conventions, formats multi-line commit bodies, and validates message structure.'

DimensionReasoningScore

Specificity

Names the domain (Ruby/Rails commits) and some actions (commit message structure, type selection, body content), but doesn't list multiple concrete discrete actions — it's more of a general guidance description than a list of specific capabilities.

2 / 3

Completeness

Explicitly answers both 'what' (guides commit message structure, type selection, and body content following Conventional Commits format) and 'when' (Use when committing code changes in Ruby or Ruby on Rails projects).

3 / 3

Trigger Term Quality

Includes strong natural trigger terms: 'committing code changes', 'Ruby', 'Ruby on Rails', 'commit message', 'Conventional Commits'. These are terms users would naturally use when needing this skill.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive — scoped specifically to Ruby/Rails projects and Conventional Commits format for commit messages. Unlikely to conflict with general git skills or non-Ruby commit message skills due to the language-specific and format-specific qualifiers.

3 / 3

Total

11

/

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.