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".
73
68%
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 completeness and distinctiveness by clearly specifying when to use the skill and targeting a narrow Evernote architecture niche. However, it is weak on specificity—it reads more like a category label than a description of concrete capabilities. The description would benefit from listing specific actions or outputs the skill provides.
Suggestions
Add concrete actions the skill performs, e.g., 'Provides API integration patterns, rate-limiting strategies, data sync architectures, and webhook configurations for Evernote applications.'
Replace abstract phrases like 'reference architecture' with specific deliverables such as 'generates architecture diagrams, defines component boundaries, recommends caching strategies.'
| 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 components 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 domain. | 3 / 3 |
Distinctiveness Conflict Risk | The combination of 'Evernote' with 'architecture' and 'integration pattern' creates a clear niche. It is unlikely to conflict with other skills since it targets a very specific platform (Evernote) and a specific concern (system architecture/integration patterns). | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a reasonably well-organized architecture reference skill that provides a clear high-level view of Evernote integration patterns with good progressive disclosure. Its main weaknesses are limited actionability (mostly descriptive rather than executable) and some verbosity in sections that restate content (Output section, Prerequisites). The error handling table is a strong addition, but the skill would benefit from more concrete, copy-paste-ready artifacts.
Suggestions
Replace the prose database schema description with actual SQL DDL that can be directly used or adapted
Add a concrete caching implementation example (e.g., Redis client setup with TTL configuration and invalidation logic) rather than just describing the strategy
Remove the Prerequisites and Output sections — Prerequisites states things Claude already knows, and Output merely restates what was covered in the body
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably efficient but includes some unnecessary sections like Prerequisites (Claude knows these concepts), verbose Output bullet list that restates what was already covered, and the Examples section which describes use cases rather than providing executable guidance. The architecture diagram and error handling table are well-structured and earn their tokens. | 2 / 3 |
Actionability | The skill provides some concrete guidance (ASCII architecture diagrams, a 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 database schema is described in prose rather than SQL, and the caching strategy lacks implementation details. For an architecture reference this is somewhat expected, but more concrete artifacts (e.g., actual schema DDL, config examples) would improve actionability. | 2 / 3 |
Workflow Clarity | The architecture layers are clearly presented and the sync flow has a logical sequence, but there are no explicit validation checkpoints or feedback loops for the design/implementation process. For an architecture skill involving system integration and sync operations, the absence of verification steps (e.g., how to validate sync state consistency, how to test the circuit breaker) is a gap. | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear sections, provides a concise overview in the main file, and appropriately references a separate implementation guide for detailed diagrams and schemas. The reference to `evernote-multi-env-setup` and `references/implementation-guide.md` are one-level-deep and clearly signaled. Navigation is straightforward. | 3 / 3 |
Total | 9 / 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 | |
3e83543
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.