CtrlK
BlogDocsLog inGet started
Tessl Logo

jamesmoss/agent-school

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

Overview
Skills
Evals
Files

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

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

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-school@0.2.0

Reviewed

Table of Contents