CtrlK
BlogDocsLog inGet started
Tessl Logo

active-storage-setup

Configures Active Storage for file uploads with variants and direct uploads. Use when adding file uploads, image attachments, document storage, generating thumbnails, or when user mentions Active Storage, file upload, attachments, or image processing.

81

Quality

82%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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 a well-crafted skill description that follows best practices. It uses third person voice, lists specific capabilities, includes a comprehensive 'Use when...' clause with natural trigger terms, and clearly identifies its Rails Active Storage niche. The description provides sufficient detail for Claude to confidently select this skill when appropriate.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Configures Active Storage', 'file uploads with variants', 'direct uploads'. These are concrete, actionable capabilities in the Rails ecosystem.

3 / 3

Completeness

Clearly answers both what ('Configures Active Storage for file uploads with variants and direct uploads') AND when with explicit 'Use when...' clause listing specific trigger scenarios and terms.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'file uploads', 'image attachments', 'document storage', 'thumbnails', 'Active Storage', 'attachments', 'image processing'. These match how developers naturally describe these needs.

3 / 3

Distinctiveness Conflict Risk

Clear niche targeting Rails Active Storage specifically. The combination of 'Active Storage', 'variants', and 'direct uploads' creates a distinct Rails-specific scope unlikely to conflict with generic file handling skills.

3 / 3

Total

12

/

12

Passed

Implementation

64%

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

This is a highly actionable Rails Active Storage skill with excellent, production-ready code examples covering models, controllers, views, and testing. The main weaknesses are its length (could benefit from splitting advanced topics into separate files) and missing validation checkpoints in the workflow for catching configuration or processing errors early.

Suggestions

Add explicit validation steps to the TDD Workflow, such as 'Verify storage service is configured: `rails active_storage:install --check`' and 'Test variant generation works before proceeding to views'

Split advanced sections (Direct Uploads, Service Methods, Performance Tips) into separate reference files linked from a condensed main skill

Remove redundant examples - choose either gem-based OR manual validation, not both, or clearly mark one as 'Alternative approach' in a collapsible section

DimensionReasoningScore

Conciseness

The skill is comprehensive but includes some redundancy (e.g., both gem-based and manual validation examples, multiple similar code patterns). Some sections could be tightened, though it avoids explaining basic concepts Claude already knows.

2 / 3

Actionability

Excellent executable code throughout - complete Ruby models, controllers, views, specs, and configuration files. All examples are copy-paste ready with realistic patterns including factories, request specs, and Turbo Stream responses.

3 / 3

Workflow Clarity

The TDD Workflow checklist provides a clear sequence, but lacks explicit validation checkpoints. For file upload operations that could fail (storage config, image processing), there are no verify-then-proceed steps or error recovery guidance.

2 / 3

Progressive Disclosure

Content is well-organized with clear section headers, but it's a monolithic 400+ line file. Advanced topics like direct uploads, service methods, and performance tips could be split into separate reference files with links from the main skill.

2 / 3

Total

9

/

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

skill_md_line_count

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

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

9

/

11

Passed

Repository
ThibautBaissac/rails_ai_agents
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.