Reference architecture for Evernote integrations. Use when designing system architecture, planning integrations, or building scalable Evernote applications. Trigger with phrases like "evernote architecture", "design evernote system", "evernote integration pattern", "evernote scale".
70
64%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/saas-packs/evernote-pack/skills/evernote-reference-architecture/SKILL.mdQuality
Discovery
79%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description excels at trigger term coverage, completeness (both what and when), and distinctiveness due to its narrow Evernote architecture niche. However, it is weak on specificity—it reads more like a category label than a description of concrete actions the skill performs. Adding specific deliverables or actions (e.g., 'generates architecture diagrams, defines API integration patterns, recommends caching strategies') would significantly improve it.
Suggestions
Add concrete actions the skill performs, e.g., 'Generates architecture diagrams, defines API integration patterns, recommends rate-limiting and caching strategies for Evernote API usage.'
Replace abstract phrases like 'reference architecture' and 'building scalable Evernote applications' with specific outputs or artifacts the skill produces.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description says 'reference architecture for Evernote integrations' but does not list any concrete actions. Terms like 'designing system architecture', 'planning integrations', and 'building scalable Evernote applications' are abstract and do not describe specific capabilities (e.g., no mention of what the skill actually produces or manipulates). | 1 / 3 |
Completeness | The description answers both 'what' (reference architecture for Evernote integrations) and 'when' (designing system architecture, planning integrations, building scalable Evernote applications) with explicit trigger phrases. Both clauses are present and clearly stated. | 3 / 3 |
Trigger Term Quality | The description explicitly lists natural trigger phrases like 'evernote architecture', 'design evernote system', 'evernote integration pattern', and 'evernote scale'. These are reasonably natural terms a user might say and provide good keyword coverage for the Evernote architecture domain. | 3 / 3 |
Distinctiveness Conflict Risk | The combination of 'Evernote' with 'architecture' and 'integration pattern' creates a very specific niche. It is unlikely to conflict with other skills unless there are multiple Evernote-related skills, and the focus on architecture/design patterns further narrows the scope. | 3 / 3 |
Total | 10 / 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 skill provides a reasonable high-level reference architecture for Evernote integrations with good structural elements (ASCII diagrams, error handling table, service patterns). However, it leans too heavily on descriptive prose rather than executable code, includes unnecessary sections (Prerequisites, Output summary), and references a bundle file that doesn't exist. The content would benefit from more concrete, copy-paste-ready implementations and actual validation steps.
Suggestions
Replace descriptive prose for caching and database schema with executable code (e.g., actual Redis configuration, SQL DDL, or ORM model definitions)
Remove the Prerequisites and Output sections — they add no actionable value and waste tokens on things Claude already knows or content that restates the body
Add validation checkpoints to the sync architecture workflow (e.g., 'verify webhook signature before processing', 'confirm USN advancement after sync batch')
Either provide the referenced 'references/implementation-guide.md' bundle file or remove the reference and inline the most critical implementation details
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient but includes some unnecessary sections like Prerequisites (Claude knows these concepts), the Output section which just restates what was already covered, and the Examples section which describes hypothetical use cases rather than providing actionable guidance. The architecture diagram and service layer sections are well-condensed. | 2 / 3 |
Actionability | Provides some concrete guidance (ASCII architecture diagram, service registry code snippet, sync flow diagram, error handling table) but most content is descriptive rather than executable. The code example is a skeleton, the caching strategy is described in prose without implementation, and the database schema is listed as column names rather than actual DDL or ORM definitions. | 2 / 3 |
Workflow Clarity | The architecture layers are clearly sequenced and the sync flow has a clear pipeline diagram. However, there are no validation checkpoints or feedback loops for the multi-step processes involved in setting up this architecture. The error handling table partially compensates but doesn't provide step-by-step recovery procedures. | 2 / 3 |
Progressive Disclosure | References an implementation guide at 'references/implementation-guide.md' and a multi-env setup skill, which is good structure. However, no bundle files are provided, so the referenced implementation guide doesn't actually exist. The main content also includes material (like the full error handling table and examples) that could be split into reference files, while the core architecture overview is appropriately concise. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
3a2d27d
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.