WebCull - Documentation

Overview

Agent Skills Give Your Agent A Safe CLI Base

The WebCull Agent Skill Set helps agent tools use the WebCull CLI carefully. Install webcull-cli first for shared safety and command guidance, then add focused workflow skills for the bookmark jobs you want help with.

webcull bookmarks count --path /
webcull bookmarks tree --path / --max-depth 1 --limit 25 --fields id,type,title,modified
webcull bookmarks search --query 'github api' --limit 20 --fields id,title,url,parent_id
webcull bookmarks get --ids 123,456 --fields id,title,url,notes --max-metadata-chars 1500

Catalog

Choose Skills By What You Want Done

webcull-cli

Base skill for login, output limits, E2EE rules, graph commands, reminders, and approval-based writes. Install this before workflow skills.

webcull-talk-to-bookmarks

Answer natural questions from saved bookmark details, snapshot text when available, and carefully selected page context.

webcull-organize-bookmarks

Inspect folder growth, propose expandable categories, and use dry-run writes only after approval.

webcull-graph-relationships

Explain what connects saved items, what points here, and how two items are related.

webcull-workflow-analysis

Find repeated tools, stale areas, active projects, crowded folders, and bookmark friction.

webcull-recommendations

Infer interests from bookmarks and suggest useful next discoveries without saving them automatically.

webcull-learning-path

Turn a folder into a guided sequence from orientation to deeper study.

webcull-public-collection-review

Inspect a folder before publishing and flag privacy, clarity, order, or presentation issues.

Skill Details

Base Skill Details

Status

Stable

Required CLI version

@webcull/cli >= 0.1.1

Install file

webcull-cli/SKILL.md

Permissions

Uses the authorized WebCull CLI token for read and write bookmark access. Write actions require your explicit request and use dry runs first.

Changelog

/skills/CHANGELOG.md

Download

/skills/webcull-cli/SKILL.md

Package

Download The Versioned Skill Bundle

The bundle includes one folder per skill, a skills.json version file, a CHANGELOG.md release note file, and install instructions for agent tools.

skills/
  skills.json
  INSTALL.md
  CHANGELOG.md
  README.md
  webcull-cli/SKILL.md
  webcull-talk-to-bookmarks/SKILL.md
  webcull-organize-bookmarks/SKILL.md
  webcull-graph-relationships/SKILL.md
  webcull-workflow-analysis/SKILL.md
  webcull-recommendations/SKILL.md
  webcull-learning-path/SKILL.md
  webcull-public-collection-review/SKILL.md

Updates

Check Skill Updates By Version And Changelog

The skills.json file shows the current bundle version and skill versions. The CHANGELOG.md file explains what changed before you update installed skill folders. Review major version changes before replacing a local copy. Minor and patch updates should keep the same basic workflow.

Request Limits

Skills Keep Requests Intentionally Small

The skill set tells agents to use --max-chars, --limit, --page, --fields, and --max-metadata-chars on broad bookmark commands. When results are too broad, the agent narrows fields first, then long text, then pages through results.

The skill set also tells agents to avoid parallel WebCull CLI calls, pace requests, and narrow the next request if WebCull asks it to slow down.

Writes

Writes Require Your Explicit Request

The skills tell agents to avoid creating, updating, moving, or reorganizing bookmarks until you ask for that write. They also prefer --dry-run before a real write, preserve unedited fields, and send the narrowest patch possible.

E2EE

Encrypted Account Passphrases Stay Local

For encrypted accounts, the CLI prompts for the E2EE passphrase only through hidden interactive terminal input. The skills tell agents not to place passphrases in CLI arguments, environment variables, config, stdin, logs, examples, or API requests.