Set up and configure Torii indexer for GraphQL queries, gRPC subscriptions, and SQL access. Use when indexing your deployed world for client queries or real-time updates.
83
75%
Does it follow best practices?
Impact
100%
1.36xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.agents/skills/dojo-indexer/SKILL.mdQuality
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 strong skill description that clearly identifies the specific tool (Torii indexer), lists concrete capabilities (GraphQL, gRPC, SQL), and provides an explicit 'Use when' clause with relevant trigger scenarios. The only minor issue is the use of second person ('your deployed world') which technically violates the third-person voice guideline, but the impact is minimal since the core description uses third-person imperative form.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Set up and configure Torii indexer', 'GraphQL queries', 'gRPC subscriptions', and 'SQL access'. These are distinct, concrete capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Set up and configure Torii indexer for GraphQL queries, gRPC subscriptions, and SQL access') and when ('Use when indexing your deployed world for client queries or real-time updates') with an explicit 'Use when...' clause. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'Torii', 'indexer', 'GraphQL', 'gRPC', 'SQL', 'subscriptions', 'queries', 'real-time updates', 'deployed world', 'client queries'. Good coverage of relevant technical terms that are also natural user language in this domain. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with specific technology references (Torii, gRPC, GraphQL) and a clear domain niche (indexing deployed worlds). Unlikely to conflict with other skills due to the specificity of the toolchain mentioned. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides excellent actionable content with executable examples across GraphQL, SQL, TypeScript, and CLI tools, but suffers significantly from verbosity — explaining what Torii is, why to use it, and including trigger phrases that waste tokens. The workflow lacks validation checkpoints (e.g., verifying Torii is indexing correctly), and the monolithic structure would benefit from splitting detailed API examples and client integration into separate files.
Suggestions
Remove the 'What is Torii?', 'When to Use This Skill', and 'What This Skill Does' sections entirely — Claude doesn't need to be told what an indexer is or see trigger phrases.
Add validation checkpoints to the workflow: after starting Torii, verify it's running (e.g., `curl http://localhost:8080/graphql` health check); after deploying with Slot, verify the endpoint is accessible.
Split detailed GraphQL query examples, client integration code, and SQL access into separate reference files (e.g., GRAPHQL.md, CLIENTS.md) and link from the main skill.
Remove generic troubleshooting items like 'Check firewall rules' and 'Verify port' that Claude already knows how to diagnose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is very verbose with sections like 'What is Torii?' explaining concepts Claude already knows (what an indexer does, why it's faster than RPC), 'When to Use This Skill' trigger phrases, and 'What This Skill Does' summary that duplicates the content. The 'Why use Torii' bullets are unnecessary filler. Multiple troubleshooting items are generic advice Claude would already know. | 1 / 3 |
Actionability | The skill provides fully executable code examples across multiple languages and tools: bash commands for starting Torii, complete GraphQL queries, SQL examples, TypeScript client integration code, TOML configuration, and Slot deployment commands. All examples are copy-paste ready with realistic syntax. | 3 / 3 |
Workflow Clarity | The Development Workflow section provides a clear 3-terminal sequence, and the Slot Deployment section has ordered steps. However, there are no validation checkpoints — no step to verify Torii is running correctly after starting it, no verification that indexing is working, and no feedback loops for error recovery in the setup process. | 2 / 3 |
Progressive Disclosure | The content is a monolithic document with everything inline — GraphQL queries, SQL access, client integration, configuration, deployment, and troubleshooting all in one file. The configuration section references an external guide, but the bulk of content (especially the extensive GraphQL examples and client integration code) would benefit from being split into separate reference files. | 2 / 3 |
Total | 8 / 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 | |
44466c6
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.