Use when adding authentication (login, logout, protected routes) to Express.js web applications - integrates express-openid-connect for session-based auth.
90
87%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Quality
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-crafted skill description that clearly identifies when to use it and specifies the technology stack. The 'Use when' clause at the beginning provides explicit trigger guidance, and the mention of specific technologies (Express.js, express-openid-connect) creates clear distinctiveness. The main weakness is that it could list more concrete actions beyond the parenthetical examples.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (authentication, Express.js) and some actions (login, logout, protected routes), but doesn't comprehensively list concrete actions like 'configure middleware', 'set up callback routes', or 'manage session tokens'. | 2 / 3 |
Completeness | Explicitly answers both what (integrates express-openid-connect for session-based auth) and when (adding authentication to Express.js apps) with a clear 'Use when' clause at the start. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'authentication', 'login', 'logout', 'protected routes', 'Express.js', 'session-based auth'. These are terms developers naturally use when seeking auth solutions. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with specific technology stack (Express.js + express-openid-connect) and clear use case (session-based auth). Unlikely to conflict with other auth skills for different frameworks or token-based auth approaches. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill with excellent actionability and progressive disclosure. The workflow is clear and the code examples are complete and executable. Minor improvements could be made to conciseness by removing duplicate route definitions and consolidating the Quick Reference with inline documentation.
Suggestions
Remove the duplicate root route definition in Step 4 - the second one with login/logout links should replace the first simple example
Consider moving the Quick Reference section to the api.md reference file to reduce redundancy with the main workflow content
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient but includes some redundancy - the root route is defined twice in Step 4, and the 'When NOT to Use' section, while useful, is somewhat verbose. The Quick Reference section duplicates information already covered in the workflow. | 2 / 3 |
Actionability | Provides fully executable, copy-paste ready code examples with complete Express.js setup, environment configuration, and route implementations. Commands are specific and the code is production-ready. | 3 / 3 |
Workflow Clarity | Clear 5-step numbered workflow with explicit actions at each stage. Includes a testing step and the Common Mistakes table serves as implicit validation guidance for common failure modes. | 3 / 3 |
Progressive Disclosure | Excellent structure with Quick Start in main file and detailed documentation clearly signaled with one-level-deep references to setup.md, integration.md, and api.md. Related skills and external references are well-organized. | 3 / 3 |
Total | 11 / 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.
fbcbfb1
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.