Qjzd Nav Cli Content

Use when managing QJZD Nav links, categories, and tags from the terminal, including list, create, update, delete operations.

Security Scan

The skill is an instruction-only helper for the qjzd-nav CLI and its requested actions, requirements, and instructions are internally consistent with that purpose.

Purpose & Capability

Name and description match the runtime instructions: all commands reference the qjzd-nav CLI and content-management actions (links, categories, tags). No unrelated services, binaries, or credentials are requested.

Instruction Scope

SKILL.md only instructs running qjzd-nav CLI commands and checking auth with qjzd-nav auth current or the companion auth skill. It does not ask the agent to read arbitrary files, environment variables, or post data to unexpected endpoints.

Install Mechanism

Instruction-only skill with no install spec and no code files; nothing is downloaded or written to disk by the skill itself.

Credentials

No environment variables, credentials, or config paths are required by the skill. Auth is referenced but delegated to qjzd-nav-cli-auth, which is appropriate for a CLI-based workflow.

Persistence & Privilege

always is false and the skill is user-invocable. It does not request persistent system presence or modify other skills' configuration.

Assessment

This skill is a documentation-style wrapper around the qjzd-nav CLI. Before using: ensure the qjzd-nav binary you have is from a trusted source, confirm the CLI's authentication method (qjzd-nav-cli-auth) is configured correctly, and be cautious when running destructive commands (delete/update/reorder)—consider exporting or backing up current data first. The skill itself does not request secrets, but the underlying CLI will require whatever credentials your QJZD Nav instance uses, so treat those credentials as sensitive.

Use this skill for qjzd-nav link, qjzd-nav category, and qjzd-nav tag.

If auth may not be ready, check qjzd-nav auth current first or load qjzd-nav-cli-auth.

Commands

qjzd-nav link --help
qjzd-nav category --help
qjzd-nav tag --help

Links

List and filter links:

qjzd-nav link list
qjzd-nav link list --category-id <id>
qjzd-nav link list --tag-ids <ids>        # comma-separated
qjzd-nav link list --keyword <keyword>
qjzd-nav link list --page 1 --page-size 20
qjzd-nav link list --json

Create a link:

qjzd-nav link create \
  --title "Google" \
  --url "https://google.com" \
  --category-id <category-id> \
  --description "Search engine" \
  --icon "i-lucide-search" \
  --tags "tag-id-1,tag-id-2" \
  --order 0

Update a link:

qjzd-nav link update --id <link-id> --title "New Title"
qjzd-nav link update --id <link-id> --url "https://new-url.com"
qjzd-nav link update --id <link-id> --category-id <new-category-id>

Delete a link:

qjzd-nav link delete --id <link-id>

Categories

List categories:

qjzd-nav category list
qjzd-nav category list --keyword <keyword>
qjzd-nav category list --page 1 --page-size 20
qjzd-nav category list --json

Create a category:

qjzd-nav category create \
  --name "Programming" \
  --description "Programming links" \
  --icon "i-lucide-code" \
  --order 0 \
  --parent-id <parent-id>   # optional, for subcategories

Update a category:

qjzd-nav category update --id <cat-id> --name "New Name"
qjzd-nav category update --id <cat-id> --icon "i-lucide-star"

Delete a category:

qjzd-nav category delete --id <cat-id>
qjzd-nav category delete --id <cat-id> --mode only --sub-action promote  # only delete category, move links to parent

Reorder categories:

qjzd-nav category reorder --items '[{"id":"xxx","order":1},{"id":"yyy","order":2}]'

Tags

List tags:

qjzd-nav tag list
qjzd-nav tag list --keyword <keyword>
qjzd-nav tag list --page 1 --page-size 20
qjzd-nav tag list --json

Create a tag:

qjzd-nav tag create --name "JavaScript" --color "#F7DF1E"

Update a tag:

qjzd-nav tag update --id <tag-id> --name "TypeScript" --color "#3178C6"

Delete a tag:

qjzd-nav tag delete --id <tag-id>

Rules

• Link categoryId is required for creating links.
• Tag IDs are comma-separated when multiple tags are needed.
• Category deletion supports --mode only to only delete the category (links move to parent/default).
• Use --json for automation and scripts.
• Use --page and --page-size for pagination.

Common Workflow Example

# 1. List categories to get IDs
qjzd-nav category list --json

# 2. List tags to get IDs
qjzd-nav tag list --json

# 3. Create a link with category and tags
qjzd-nav link create \
  --title "GitHub" \
  --url "https://github.com" \
  --category-id <cat-id> \
  --tags "<tag-id-1>,<tag-id-2>"