kirk-haodong/yinxiang-cli

Evernote Skill

This Skill provides Claude Code with secure automation capabilities for Yinxiang Biji (app.yinxiang.com), the mainland China version of Evernote.

Core Principles

• Read-only first: Any write operation must first show a preview and obtain user confirmation.
• CLI execution: Never call the Evernote API directly; all operations go through the evernote CLI.
• No token persistence: The token must never be saved to the Skill, conversation, or code.
• Validate first: Before and after batch modifications, always snapshot/verify.

Available Commands

evernote auth status       # Check authentication status
evernote auth setup        # Show token configuration instructions
evernote doctor            # Diagnostics
evernote notebooks list    # List notebooks
evernote tags list         # List tags
evernote notes list        # List notes
evernote notes search <q>  # Search notes
evernote notes get <guid>  # Get note details

Workflows

1. Initial Authentication

1. Prompt the user to visit https://app.yinxiang.com/api/DeveloperToken.action
2. Set export EVERNOTE_TOKEN='S=...'
3. Run evernote auth status to verify

2. Organizing Notes

1. evernote notes list --format json to export metadata
2. Analyze note topics and categorize by content
3. Generate a classification plan as JSON
4. Show a classification summary to the user for confirmation
5. Execute write operations only after user confirmation

3. Importing Documents

1. Confirm the target notebook exists
2. evernote import directory ./docs --notebook "Target"

Security Requirements

• Take a snapshot before any batch delete
• Preview all tag changes before applying
• Confirm the target notebook structure before moving notes
• Always display the raw error message on any error