CtrlK
BlogDocsLog inGet started
Tessl Logo

igmarin/hanakai-yaku

Curated library of atomic skills and personas for Hanami, dry-rb, and ROM Ruby development. Covers actions, slices, repositories, relations, changesets, providers, DI, operations, TDD, CLI, views, routing, validation, and 10 orchestration personas. Shared Ruby process skills have moved to ruby-core-skills. Uses Markdown + Front-matter architecture.

95

1.20x
Quality

95%

Does it follow best practices?

Impact

96%

1.20x

Average score across 45 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

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 strong, well-crafted security review skill. It provides a systematic audit workflow with concrete grep commands, clear severity classifications, and executable Ruby remediation patterns — all without over-explaining security concepts Claude already understands. The only minor weakness is that the Core Rules section is somewhat lengthy inline, and the referenced related skills have no supporting bundle files.

DimensionReasoningScore

Conciseness

The skill is lean and efficient. It avoids explaining what CSRF, SQL injection, or XSS are — it assumes Claude knows these concepts. Every section serves a direct purpose: the table drives the audit workflow, the core rules provide concrete remediation patterns, and there's no filler text.

3 / 3

Actionability

Highly actionable: provides specific grep commands for each audit step, executable Ruby code examples for both good and bad patterns, and concrete remediation snippets that are copy-paste ready. Each concern has a clear detection method and fix.

3 / 3

Workflow Clarity

The 10-step review workflow is clearly sequenced in a table with explicit red flags and severity levels. The completion checkpoint provides a structured way to compile findings with severity tiers, and each finding maps back to a specific Core Rule for remediation — forming a clear feedback loop.

3 / 3

Progressive Disclosure

The content is well-structured with clear sections (Review Workflow, Core Rules, Integration), and the Integration table references related skills. However, the Core Rules section is fairly lengthy inline content that could potentially be split out, and there are no bundle files to support progressive disclosure despite references to related skills.

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 a strong skill description that excels across all dimensions. It opens with an explicit 'Use when' clause containing multiple natural trigger terms, lists highly specific and actionable security checks tied to the Hanami 2.x framework, and is clearly distinguishable from generic security review skills. The only minor weakness is that it is quite long, but the density of information is justified by the breadth of security concerns covered.

DimensionReasoningScore

Specificity

The description lists numerous specific concrete actions: validate params via Params DSL, verify CSRF protection in config/app.rb, audit authentication checks via explicit `before :authenticate!`, check authorization with role/permission checks, prevent SQL injection by using ROM query interface, avoid `raw` on user input, store secrets in settings, and return generic error messages for auth failures.

3 / 3

Completeness

The description explicitly answers both 'what' (a comprehensive list of security checks for Hanami 2.x apps) and 'when' (opens with 'Use when conducting a security audit, security review, vulnerability assessment...'). The 'Use when' clause is explicit and detailed.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'security audit', 'security review', 'vulnerability assessment', 'vulnerability check', 'secure coding review', 'Hanami 2.x', plus domain-specific terms like CSRF, SQL injection, XSS, authentication, authorization, and session configuration.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive due to the specific focus on Hanami 2.x framework security auditing with framework-specific details like Params DSL, ROM query interface, config/app.rb, and `before :authenticate!`. This is unlikely to conflict with general security or other framework-specific skills.

3 / 3

Total

12

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed

Reviewed

Table of Contents