Analyze and optimize Aptos Move contracts for gas efficiency, identifying expensive operations and suggesting optimizations. Triggers on: 'optimize gas', 'reduce gas costs', 'gas analysis', 'make contract cheaper', 'gas efficiency', 'analyze gas usage', 'reduce transaction costs'.
64
52%
Does it follow best practices?
Impact
83%
1.03xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.claude/skills/analyze-gas-optimization/SKILL.mdQuality
Discovery
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 well-constructed skill description that clearly defines its niche (Aptos Move gas optimization) and provides explicit trigger terms. Its main weakness is that the capability description could be more specific about the concrete actions performed (e.g., specific optimization patterns like storage access reduction, vector operation batching). Overall it scores well across all dimensions.
Suggestions
Add more specific concrete actions, e.g., 'identifies redundant storage reads, suggests struct packing, optimizes vector operations, and recommends global storage access patterns' to improve specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Aptos Move contracts, gas efficiency) and some actions (analyze, optimize, identify expensive operations, suggest optimizations), but the actions are somewhat generic and not highly concrete—e.g., it doesn't specify what kinds of optimizations or what 'expensive operations' means in practice. | 2 / 3 |
Completeness | Clearly answers both 'what' (analyze and optimize Aptos Move contracts for gas efficiency, identifying expensive operations and suggesting optimizations) and 'when' (explicit 'Triggers on:' clause with multiple trigger phrases). | 3 / 3 |
Trigger Term Quality | Includes a strong set of natural trigger terms that users would actually say: 'optimize gas', 'reduce gas costs', 'gas analysis', 'make contract cheaper', 'gas efficiency', 'analyze gas usage', 'reduce transaction costs'. These cover multiple natural phrasings well. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive—targets a specific niche (Aptos Move contracts + gas optimization) with domain-specific trigger terms that are unlikely to conflict with general code review, Solidity gas optimization, or other blockchain skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
14%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is an extensive reference catalog of Aptos Move gas optimization patterns but fails as an actionable skill. It is far too verbose, lacks a clear workflow for Claude to follow when analyzing a contract, and dumps all content into a single monolithic file. The code examples are a strength but are undermined by the lack of structure and process guidance.
Suggestions
Add a clear sequential workflow at the top: 1) Read the contract, 2) Identify expensive patterns (with specific checklist), 3) Apply optimizations, 4) Measure before/after gas, 5) Verify correctness — with explicit validation steps between stages.
Cut content by at least 50%: remove trigger phrase repetition, eliminate BAD examples (just show the GOOD pattern with a one-line note about what to avoid), condense checklists, and remove the report template or move it to a separate file.
Split into multiple files: keep SKILL.md as a concise overview with workflow, move detailed patterns to PATTERNS.md, the report template to REPORT_TEMPLATE.md, and measurement techniques to MEASUREMENT.md.
Fix the gas profiling example — `gas::remaining_gas()` is not a real Aptos Move API. Provide an actually executable measurement approach or clearly note limitations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~350+ lines. It repeats trigger phrases already in the YAML description, explains basic concepts Claude knows (what vectors are, what O(n) means), includes a full report template, and has extensive checklists that could be drastically condensed. Many patterns are shown with both BAD and GOOD examples when just the GOOD pattern with a brief note would suffice. | 1 / 3 |
Actionability | The code examples are concrete and mostly executable Move code, which is good. However, the gas profiling section uses a non-existent `gas::remaining_gas()` API, the simulation command is generic, and the skill is more of a reference catalog than actionable step-by-step guidance for analyzing a specific contract. It describes patterns rather than instructing Claude on how to systematically analyze and optimize a given contract. | 2 / 3 |
Workflow Clarity | There is no clear sequential workflow for performing a gas analysis. The skill is organized as a reference catalog of patterns and checklists but lacks a defined process: how to start analyzing a contract, what order to check things, when to validate, and how to iterate. The checklists at the end are helpful but disconnected from any workflow. No validation checkpoints or feedback loops exist for the optimization process. | 1 / 3 |
Progressive Disclosure | The content is a monolithic wall of text with no bundle files to reference. It mentions `STORAGE_OPTIMIZATION.md` but no such file exists. All content—expensive operations, optimization patterns, measurement, checklists, report template—is inlined in a single massive file with no meaningful separation or navigation structure. | 1 / 3 |
Total | 5 / 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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 9 / 11 Passed | |
919362b
Table of Contents
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.