← Back to Skills Marketplace
146
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install eagle-skill
Description
Control Eagle application for digital asset management - search, organize, tag items, manage folders and tag groups. Use when user wants to interact with the...
README (SKILL.md)
Eagle API Skill
Control the local Eagle application through CLI commands. Eagle is a digital asset management tool for organizing images, videos, fonts, and design files.
Prerequisites
- Eagle application must be running
- Eagle MCP plugin must be enabled (provides the local API server on port 41596)
CLI Usage
The CLI script is located at scripts/eagle-api-cli.js relative to this skill directory.
# Call a tool with JSON parameters
node scripts/eagle-api-cli.js call \x3Ctool_name> --json '{"key": "value"}'
# Call a tool with individual parameters
node scripts/eagle-api-cli.js call \x3Ctool_name> --param1 value1 --param2 value2
# List all available tools
node scripts/eagle-api-cli.js list
# Get help for a specific tool
node scripts/eagle-api-cli.js help \x3Ctool_name>
Array and object values are auto-parsed from JSON:
node scripts/eagle-api-cli.js call item_get --tags '["photo","landscape"]' --limit 10
Tool Categories
Choose the relevant reference file for detailed tool documentation:
- App — Get Eagle app info (version, platform, locale). See references/app-tools.md
- Item — Search, filter, add, update, tag, and organize library items. See references/item-tools.md
- Folder — Create, query, and update folder hierarchy. See references/folder-tools.md
- Tag — Query, count, rename, and merge tags. See references/tag-tools.md
- Tag Group — Manage tag groups and tag associations. See references/tag-group-tools.md
- AI Search — Semantic search by text or similar items (requires AI Search plugin). See references/ai-search-tools.md
Common Workflows
Search for items
# Text search
node scripts/eagle-api-cli.js call item_query --query "sunset landscape"
# Filter by tags and extension
node scripts/eagle-api-cli.js call item_get --tags '["photo"]' --ext "jpg" --limit 20
# Get selected items in Eagle
node scripts/eagle-api-cli.js call item_get_selected
Organize items
# Add tags to items
node scripts/eagle-api-cli.js call item_add_tags --json '{"ids": ["item1", "item2"], "tags": ["reviewed", "approved"]}'
# Move items to folders
node scripts/eagle-api-cli.js call item_add_to_folders --json '{"ids": ["item1"], "folders": ["folder_id"]}'
# Create a new folder
node scripts/eagle-api-cli.js call folder_create --json '{"folders": [{"name": "My Folder", "iconColor": "blue"}]}'
Tag management
# List all tags
node scripts/eagle-api-cli.js call tag_get
# Merge duplicate tags
node scripts/eagle-api-cli.js call tag_merge --json '{"sourceTags": ["photo", "photograph"], "targetTag": "photo"}'
Usage Guidance
This skill appears to be a local CLI wrapper for the Eagle application and is internally consistent, but review the included script before running. Practical steps: (1) ensure you have Node.js installed (SKILL.md assumes 'node' even though the registry didn't list it); (2) inspect scripts/eagle-api-cli.js for any outbound network requests or filesystem operations you don't expect; (3) only use it if your Eagle MCP plugin (local API) is trusted and you consent to the CLI controlling your local Eagle library; (4) if unsure, run the script in a restricted environment (VM or container) or ask the publisher for source verification.
Capability Analysis
Type: OpenClaw Skill
Name: eagle-skill
Version: 1.0.0
The skill bundle provides a legitimate interface for controlling the Eagle digital asset management application via a local API server. The primary script, 'scripts/eagle-api-cli.js', is a clean Node.js implementation using only built-in modules to communicate with a local endpoint (127.0.0.1:41596), and the documentation in 'SKILL.md' and the 'references/' directory accurately describes the intended functionality without any signs of malicious intent or prompt injection.
Capability Assessment
Purpose & Capability
The skill claims to control the local Eagle application and the included CLI script appears to target Eagle's local MCP API (port 41596), which matches the stated purpose. Minor inconsistency: SKILL.md and examples rely on the 'node' runtime, but the registry metadata lists no required binaries — the skill effectively requires Node.js to run the bundled script.
Instruction Scope
SKILL.md instructs the agent (or user) to run the included Node.js CLI which calls the local Eagle MCP API. The instructions do not ask the agent to read unrelated host files or environment variables, nor to send data to non-Eagle endpoints in the documentation.
Install Mechanism
There is no install spec and no downloads; the skill ships a single self-contained Node.js script that will be executed when invoked. This is lower risk than remote downloads, but executing bundled code still requires trust and review.
Credentials
No environment variables, credentials, or config paths are requested. The skill's access needs (local API on port 41596) are proportional to its purpose.
Persistence & Privilege
always:false and no persistence or system-wide config changes are requested. The skill does not request permanent inclusion or special privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install eagle-skill - After installation, invoke the skill by name or use
/eagle-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of eagle-skill (version 1.0.0)
- Enables CLI-based control of the Eagle digital asset management application for local libraries
- Supports searching, tagging, organizing, and managing digital assets, folders, tags, and tag groups
- Integrates tool categories: App, Item, Folder, Tag, Tag Group, and AI Search
- Provides CLI command examples and detailed workflow instructions in documentation
Metadata
Frequently Asked Questions
What is Eagle Skill?
Control Eagle application for digital asset management - search, organize, tag items, manage folders and tag groups. Use when user wants to interact with the... It is an AI Agent Skill for Claude Code / OpenClaw, with 146 downloads so far.
How do I install Eagle Skill?
Run "/install eagle-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Eagle Skill free?
Yes, Eagle Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Eagle Skill support?
Eagle Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Eagle Skill?
It is built and maintained by 长安 (@roaycl); the current version is v1.0.0.
More Skills