performance-optimization
Identifies and fixes Rails performance issues including N+1 queries, slow queries, and memory problems. Use when optimizing queries, fixing N+1 issues, improving response times, or when user mentions performance, slow, optimization, or Bullet gem.
Install with Tessl CLI
npx tessl i github:fernandezbaptiste/rails_ai_agents --skill performance-optimization90
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
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 excels across all dimensions. It provides specific capabilities (N+1 queries, slow queries, memory problems), includes natural trigger terms developers would use, explicitly states both what it does and when to use it, and has a clear Rails-specific niche that distinguishes it from other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Identifies and fixes Rails performance issues including N+1 queries, slow queries, and memory problems.' These are concrete, actionable capabilities in the Rails domain. | 3 / 3 |
Completeness | Clearly answers both what ('Identifies and fixes Rails performance issues including N+1 queries, slow queries, and memory problems') AND when ('Use when optimizing queries, fixing N+1 issues, improving response times, or when user mentions performance, slow, optimization, or Bullet gem'). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'performance', 'slow', 'optimization', 'N+1', 'Bullet gem', 'queries', 'response times'. These are terms developers naturally use when discussing Rails performance issues. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on Rails performance optimization with distinct triggers like 'N+1', 'Bullet gem', and 'Rails performance'. Unlikely to conflict with general coding or other framework skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%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, actionable skill with excellent executable code examples and clear BAD/GOOD pattern comparisons. The workflow includes proper validation through Bullet test integration and query count assertions. Main weakness is the monolithic structure - at 400+ lines, it would benefit from splitting into focused reference files, and some explanatory content (like N+1 SQL output examples) could be trimmed since Claude understands these concepts.
Suggestions
Split detailed sections (Database Indexing, Memory Optimization, Rack Mini Profiler) into separate reference files linked from the main skill to improve progressive disclosure
Remove or condense the 'Generated SQL' comment blocks in the N+1 section - Claude understands what N+1 queries produce without explicit SQL examples
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive but includes some unnecessary explanations Claude would know (e.g., explaining what N+1 queries are with detailed SQL output). The 'Generated SQL' comments and some table explanations could be trimmed while preserving clarity. | 2 / 3 |
Actionability | Excellent executable code throughout - all examples are copy-paste ready with proper Ruby syntax, complete Gemfile entries, configuration blocks, and migration commands. The patterns show both BAD and GOOD approaches with concrete implementations. | 3 / 3 |
Workflow Clarity | Clear workflows with explicit validation steps: Bullet configuration includes test environment setup that fails on N+1, the Performance Checklist provides a clear pre-deployment sequence, and the testing section shows how to verify query counts. The spec examples include proper setup/teardown patterns. | 3 / 3 |
Progressive Disclosure | Content is well-organized with clear sections and a logical flow from setup to patterns to testing. However, this is a monolithic 400+ line file that could benefit from splitting detailed sections (like Database Indexing, Memory Optimization) into separate reference files with links from the main skill. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
Total | 10 / 11 Passed | |
- 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.