Agent skill · software engineering · jeremylongshore

evernote-common-errors

Diagnose and fix common Evernote API errors.

Why this skill is useful

Provides specific error handling patterns and validation scripts for the Evernote API that the AI wouldn't reliably generate on its own.

What it needs

Requires evernote account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.

What this skill does

Evernote Common Errors Overview Comprehensive guide to diagnosing and resolving Evernote API errors. Evernote uses three exception types: EDAMUserException (client errors), EDAMSystemException (server/rate limit errors), and EDAMNotFoundException (invalid GUIDs). Prerequisites Basic Evernote SDK setup Understanding of Evernote data model Instructions EDAMUserException Error Codes Code Name Cause Fix ------ ------ ------- ----- 1 BADDATAFORMAT Invalid ENML, missing DOCTYPE Validate ENML before sending; check for forbidden elements 2 DATAREQUIRED Missing required field (title, content) Ensure note.title and note.content are set 3 PERMISSIONDENIED API key lacks permissions Request additional permissions from Evernote 4 INVALIDAUTH Invalid or revoked token Re-authenticate user via OAuth 5 AUTHEXPIRED Token past expiration date Check edamexpires, refresh token 6 LIMITREACHED Account limit exceeded (250 notebooks) Clean up resources before creating new ones 7 QUOTAREACHED Monthly upload quota exceeded Check user.accounting.remaining ENML Validation The most common error is BADDATAFORMAT from invalid ENML. Validate before sending: EDAMSystemException Handling Rate limit errors include rateLimitDuration (seconds to wait). Maintenance errors should be retried with progressive backoff. EDAMNotFoundException Handling Thrown when a GUID does not exist (deleted note, wrong user, invalid format). Handle gracefully by returning null instead of throwing. Error Handler Service Build a centralized error handler that classifies exceptions and returns structured results with type, code, action, and recoverable flags. See Implementation Guide for the complete EvernoteErrorHandler class. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills jeremylongshore/evernote-common-errors--e00dc0

View the source on GitHub

Browse the @skills marketplace