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

70

Quality

64%

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

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

DimensionReasoningScore

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.

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.