skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
slax-lab/slax-reader-cli83 installs

slax-reader

Use Slax Reader CLI to save URLs/bookmarks to the user's reading library, list and get bookmarks, authenticate with reader-cli, check account status, archive URLs, tag bookmarks, and handle reader-cli upgrade or skill sync hints. Trigger when the user asks to save, bookmark, archive, list, get, or organize web links with Slax Reader.

How do I install this agent skill?

npx skills add https://github.com/slax-lab/slax-reader-cli --skill slax-reader
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides a CLI-based interface for the Slax Reader bookmarking service, allowing users to save, list, archive, and manage their reading library. It includes appropriate safety guidelines for handling authentication and API keys.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

Slax Reader CLI

Use reader-cli to save URLs into the user's Slax Reader library, list saved bookmarks, and get bookmark details.

Before using authenticated commands

Check login state before saving, listing, getting, archiving, tagging, or otherwise accessing the user's Slax Reader account:

reader-cli whoami --json

If not logged in, prefer asking the user to run interactive reader-cli login when they can use a terminal. If they cannot complete the interactive flow, offer reader-cli login --api-key <key> --json and ask for an API key only if they explicitly choose that path.

Do not require a login check before login, logout, upgrade --check, skill --check, or skill --sync.

Commands

TaskCommand
Log in interactivelyreader-cli login
Log in non-interactivelyreader-cli login --api-key <key> --json
Log outreader-cli logout --json
Show accountreader-cli whoami --json
Save URLreader-cli add <url> --json
Save with titlereader-cli add <url> --title "Title" --json
Save with descriptionreader-cli add <url> --description "Description" --json
Save with tagsreader-cli add <url> --tags "tag1,tag2" --json
Archive URLreader-cli add <url> --archive --json
List bookmarksreader-cli list --json
List bookmarks by pagereader-cli list --page <number> --size <number> --json
Filter bookmarksreader-cli list --filter <all|inbox|archive|starred> --json
Get bookmark detailreader-cli get <bookmark-id>
Get bookmark as Markdownreader-cli get <bookmark-id> --markdown
Archive a bookmarkreader-cli archive <bookmark-id> --json
Unarchive a bookmarkreader-cli unarchive <bookmark-id> --json
Star a bookmarkreader-cli star <bookmark-id> --json
Unstar a bookmarkreader-cli unstar <bookmark-id> --json
Delete a bookmark (recoverable)reader-cli delete <bookmark-id> --json
Restore a deleted bookmarkreader-cli restore <bookmark-id> --json
Check CLI updatereader-cli upgrade --check --json
Sync skillreader-cli skill --sync --json
Check skill syncreader-cli skill --check --json

Bookmark rules

  • Preserve the exact URL the user asked to save.
  • Add --json when you invoke commands that support it so update hints are visible.
  • Use comma-separated tags with --tags "tag1,tag2".
  • Use --archive only when the user asks to archive/preserve content or when they explicitly approve archive mode.
  • If the user provides multiple URLs, save them one at a time so failures are isolated.

Listing and getting bookmarks

  • Use reader-cli list when the user wants to see their saved bookmarks.
  • Use reader-cli list --filter inbox, reader-cli list --filter archive, or reader-cli list --filter starred when the user asks for a specific subset.
  • Use --page and --size when the user asks for pagination or a specific number of results.
  • Use reader-cli get <bookmark-id> when the user asks to open, inspect, summarize, or read details for a specific bookmark ID.
  • Use reader-cli get <bookmark-id> --markdown when the user wants the content in Markdown format (e.g. for further processing or display).
  • Do not guess bookmark IDs; ask the user for an ID or list bookmarks first.

Organizing bookmarks

  • add <url> --archive is a save-time mode for a new URL; archive <bookmark-id> moves an already-saved bookmark out of the inbox. They are unrelated — do not confuse them.
  • Use reader-cli archive <bookmark-id> when the user wants to archive a bookmark; use reader-cli unarchive <bookmark-id> to move it back to the inbox.
  • Use reader-cli star <bookmark-id> / reader-cli unstar <bookmark-id> when the user wants to star or unstar a bookmark.
  • Use reader-cli delete <bookmark-id> to delete a bookmark — this is recoverable, not permanent. Use reader-cli restore <bookmark-id> to undo it.
  • Confirm with the user before deleting a bookmark unless they've already clearly asked you to delete it.
  • Do not guess bookmark IDs for any of these actions; ask the user for an ID or list bookmarks first.

Update and skill hints

reader-cli --json commands may include a top-level _hints object.

_hints.upgrade

When _hints.upgrade appears, finish the user's current request first. Then tell the user there is a newer CLI version and offer to run:

reader-cli upgrade

reader-cli upgrade also syncs the AI Agent skill when needed.

_hints.skill

When _hints.skill appears, finish the user's current request first. Then tell the user the installed AI Agent skill is out of sync with the CLI and offer the same repair command:

reader-cli upgrade

After the skill is synced, tell the user to restart the Agent so the updated skill is loaded. Resuming an old conversation after restart is fine.

Use reader-cli skill --sync --json only as a direct manual fallback when reader-cli upgrade cannot be used.

Do not silently ignore _hints.

Security rules

  • Never print the full API key in conversation or command output.
  • Confirm with the user before saving URLs unless the user has already clearly asked you to save them.
  • Do not invent URLs. Save only URLs provided by the user or found during an authorized research task.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/slax-lab/slax-reader-cli/slax-reader">View slax-reader on skillZs</a>