Investigates a problem area in the codebase and finds or creates a tessl tile (rules, docs, skills) to teach agents how to handle it correctly. Use when agents keep making the same mistakes around a library, design pattern, or convention.
73
Quality
73%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Discovery
75%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 description effectively communicates when to use the skill with a clear 'Use when...' clause targeting repeated agent mistakes. However, it could be stronger by listing more specific concrete actions it performs and including additional natural trigger terms users might use when describing recurring agent issues.
Suggestions
Add more specific concrete actions like 'analyzes error patterns', 'generates rule files', 'creates documentation templates' to improve specificity
Include additional natural trigger terms such as 'recurring errors', 'agent keeps failing', 'repeated issues', 'wrong approach' to improve discoverability
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (tessl tiles - rules, docs, skills) and describes the general action (investigates, finds or creates), but lacks specific concrete actions like 'analyzes error patterns', 'generates rule files', or 'updates documentation'. | 2 / 3 |
Completeness | Clearly answers both what ('Investigates a problem area and finds or creates a tessl tile') and when ('Use when agents keep making the same mistakes around a library, design pattern, or convention') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes some relevant terms like 'same mistakes', 'library', 'design pattern', 'convention', but misses common variations users might say like 'recurring errors', 'repeated issues', 'agent keeps failing', 'wrong approach'. | 2 / 3 |
Distinctiveness Conflict Risk | Has a clear niche focused on tessl tiles and agent mistake patterns - unlikely to conflict with general coding skills or documentation skills due to the specific 'agents making repeated mistakes' trigger. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a well-structured workflow for investigating codebase problems and creating tiles, with clear phases and decision points. However, it delegates the core tile creation work to another skill, reducing its standalone actionability. The content could be tightened by removing redundant explanations and trusting Claude to understand the tile system.
Suggestions
Remove the bullet list explaining what tiles contain (rules, docs, skills) — this context is better suited for the tile-creator skill that actually needs it
Consolidate the 'Important Notes' section into the relevant phases rather than repeating guidance at the end
Add a concrete example of a search query and expected result format to make Phase 2 more actionable
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some unnecessary explanation (e.g., explaining what tiles contain when Claude could infer this). The 'Important Notes' section repeats guidance already covered in the phases. | 2 / 3 |
Actionability | Provides clear phase structure and specific commands like `tessl install` and `tessl status`, but delegates the actual tile creation to another skill rather than providing executable guidance. The interview questions are helpful but the core action is outsourced. | 2 / 3 |
Workflow Clarity | Excellent multi-phase workflow with clear sequencing (Interview → Search → Create → Verify). Each phase has explicit steps, decision points (install existing vs create new), and a verification checkpoint at the end. | 3 / 3 |
Progressive Disclosure | Content is well-organized with clear sections, but everything is inline in one file. The delegation to `tessleng/tile-creator` is appropriate progressive disclosure, but the skill itself could benefit from separating the detailed interview questions or search strategies into referenced materials. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
87%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 14 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
Total | 14 / 16 Passed | |
Install with Tessl CLI
npx tessl i jamesmoss/agent-schoolReviewed
Table of Contents