CtrlK
BlogDocsLog inGet started
Tessl Logo

evernote-reference-architecture

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

Quality

68%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

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.md
SKILL.md
Quality
Evals
Security

Quality

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.'

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
jeremylongshore/claude-code-plugins-plus-skills
Reviewed

Table of Contents

Is this your skill?

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.