Qjzd Nav Cli

Use when the task involves QJZD Nav CLI, including managing links, categories, tags, backups, settings, or authentication.

Security Scan

The skill is an instruction-only router for the QJZD Nav CLI and its requirements and instructions are consistent with that purpose, but you should verify the qjzd-nav binary's provenance before use.

Purpose & Capability

The skill describes a CLI router for QJZD Nav and only requires the qjzd-nav binary, which is exactly what you'd expect for this purpose. No unrelated binaries, env vars, or installs are requested.

Instruction Scope

SKILL.md stays within CLI usage (help, completion, commands) and references standard config locations ($QJZD_NAV_CLI_CONFIG_DIR, $XDG_CONFIG_HOME, $HOME) and system keyring storage. These references are expected for a CLI but do mean the agent (when running the qjzd-nav binary) may read config files and use the OS keyring for credentials.

Install Mechanism

No install spec is provided; this is instruction-only and will not download or write code. That is the lowest-risk install profile.

Credentials

The skill declares no required environment variables or credentials. The documented use of the system keyring and standard config paths is proportionate to a CLI that stores profiles and credentials.

Persistence & Privilege

The skill is not always-on and is user-invocable; it does not request elevated or persistent platform privileges nor indicate it will modify other skills or global agent settings.

Assessment

This skill is internally consistent for controlling a local qjzd-nav CLI. Before installing or invoking it, verify that the qjzd-nav binary on your system is the official/trusted binary (check its source, checksum, or package manager). Be aware the CLI will read config files (e.g., ~/.config/qjzd-nav/config.json) and uses the OS keyring to store credentials — if you don't trust the binary, do not allow it to access those stores. If you want to be extra cautious, run qjzd-nav --help and a few safe read-only commands locally to inspect behavior before allowing an agent to invoke it autonomously.

This is the routing skill for the QJZD Nav CLI skill set.

If the request only says "use QJZD Nav CLI" or mixes multiple areas, start here, then jump to the domain skill that matches the task.

Skill Map

• qjzd-nav-cli-auth: login, profile setup, profile switching, keyring and credential repair
• qjzd-nav-cli-content: links, categories, and tags management
• qjzd-nav-cli-operations: backup, restore, and settings management

Fast Routing

Use these commands to identify the right area:

qjzd-nav --help
qjzd-nav auth --help
qjzd-nav link --help
qjzd-nav category --help
qjzd-nav tag --help
qjzd-nav backup --help
qjzd-nav settings --help
qjzd-nav completion --help

Shell Completion

Generate and install shell completion scripts:

# Bash
eval "$(qjzd-nav completion bash)"

# Zsh
eval "$(qjzd-nav completion zsh)"

After enabling completion, press <kbd>Tab</kbd> to complete commands:

qjzd-nav <TAB>
qjzd-nav auth <TAB>
qjzd-nav link <TAB>

Shared Defaults

• Prefer an authenticated profile unless the task is public.
• Use --profile <name> when the environment matters.
• Use --json for automation.
• Use --force carefully for destructive non-interactive operations.

Top-Level Areas

• auth - Authentication and profile management
• link - Link CRUD operations
• category - Category CRUD operations
• tag - Tag CRUD operations
• backup - Backup and restore operations
• settings - Site settings management

Config And Secrets

Profile metadata is stored in:

• $QJZD_NAV_CLI_CONFIG_DIR/config.json if QJZD_NAV_CLI_CONFIG_DIR is set
• otherwise $XDG_CONFIG_HOME/qjzd-nav/config.json
• otherwise $HOME/.config/qjzd-nav/config.json

Credentials are stored in the system keyring via @napi-rs/keyring.