Registers engine-level middleware functions that run before HTTP handlers. Use when adding authentication, request logging, rate limiting, or any pre-handler logic to HTTP endpoints.
80
75%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/iii-http-middleware/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 well-crafted skill description that clearly communicates both what the skill does and when to use it. It uses third-person voice, includes specific concrete actions, and provides natural trigger terms that developers would use. The description is concise yet comprehensive, with a clear niche that minimizes conflict risk.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'registers engine-level middleware functions', 'authentication', 'request logging', 'rate limiting', 'pre-handler logic to HTTP endpoints'. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Registers engine-level middleware functions that run before HTTP handlers') and when ('Use when adding authentication, request logging, rate limiting, or any pre-handler logic to HTTP endpoints') with an explicit 'Use when' clause. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'middleware', 'authentication', 'request logging', 'rate limiting', 'pre-handler logic', 'HTTP endpoints', 'HTTP handlers'. These cover the common terms developers use when needing this functionality. | 3 / 3 |
Distinctiveness Conflict Risk | Clearly scoped to engine-level middleware and pre-handler logic for HTTP endpoints. The specificity of 'engine-level middleware' and the enumerated use cases (authentication, rate limiting, logging) make it distinct and unlikely to conflict with general HTTP handler or routing skills. | 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.
This is a competent middleware skill that clearly explains the middleware chain concept, provides useful code fragments, and has good structural organization with a primitives table and architecture diagram. Its main weaknesses are the lack of a complete inline executable example (relying on an unverifiable external reference), some boilerplate sections that don't add value, and missing error handling/validation guidance for middleware setup.
Suggestions
Include a minimal but complete inline executable example showing at least one middleware function registered and attached to a trigger, rather than relying solely on the external reference file.
Remove or consolidate the generic 'When to Use' and 'Boundaries' sections at the bottom — these are boilerplate that Claude doesn't need.
Add error handling guidance: what happens when middleware throws an exception, and how to verify middleware is correctly attached and executing in the expected order.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient but includes some redundant sections. The 'When to Use' and 'Boundaries' sections at the bottom repeat generic boilerplate that doesn't add value. The 'Adapting This Pattern' section contains advice Claude could infer. However, the core technical content (key concepts, primitives table, common patterns) is reasonably tight. | 2 / 3 |
Actionability | The skill provides concrete code snippets in the Common Patterns section and a clear primitives table, but lacks a complete, executable example inline. It references an external file (http-middleware.js) for the full working example, but since no bundle files are provided, we can't verify that exists. The patterns shown are fragments rather than copy-paste ready implementations. | 2 / 3 |
Workflow Clarity | The architecture diagram clearly shows the middleware chain execution order, and the key concepts explain continue/respond flow well. However, there are no explicit validation steps or error handling guidance — e.g., what happens when middleware throws, how to debug middleware ordering issues, or how to verify middleware is correctly attached to triggers. | 2 / 3 |
Progressive Disclosure | The skill references an external implementation file (../references/http-middleware.js) which is good progressive disclosure, but since no bundle files are provided, we cannot verify the reference exists. The skill also references other skills (iii-http-endpoints, RBAC) in Pattern Boundaries but without links. The inline content is reasonably structured with clear sections but the Common Patterns section contains substantial code fragments that might be better served by the reference file alone. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
d51a06d
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.