SZU Campus Affairs CLI Skill for Openclaw

Openclaw Skills for SZU Campus Affairs CLI turn campus requests into safe, JSON-first szu-cli command workflows.

awesomehou
v0.2.1
Jul 11, 2026
0
813
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install szu-campus

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install szu-campus using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is SZU Campus Affairs CLI Skill?

Openclaw Skills for SZU Campus Affairs CLI provide a precise, developer-friendly way to work with Shenzhen University services through the local szu-cli tool. It covers campus login checks, notices, personal timetables, full-school schedules, grades, ranking information, training plans, academic completion, ideology credits, innovation lectures, dorm electricity, sports venue reservations, library holdings, and CNKI/Wanfang academic searches.

This skill is guidance-only and intentionally avoids browser automation, scraping, or custom business logic. Instead, it standardizes how an agent should invoke the installed CLI, prefer --json output, respect privacy boundaries, require explicit confirmation for state-changing actions, and rely on the installed szu-cli contract and reference docs as the source of truth.

SZU Campus Affairs CLI Skill Use Cases

  • Verify the local environment before any campus operation with node --version, szu-cli --version, szu-cli doctor --json, and szu-cli auth status --json.
  • Log in to SZU services through the browser window opened by the CLI when authentication is required.
  • Query academic and campus data such as notices, class schedules, grades, rankings, training plans, completion status, ideology credits, and innovation lecture records.
  • Check operational services like dorm electricity, library holdings, and academic database metadata for CNKI and Wanfang.
  • Reserve or cancel sports venues using --dry-run first, then --confirm only after the target field is explicitly identified.
  • Build agent workflows that consume structured JSON rather than parsing prose from stdout.
  • Preserve privacy by returning only the minimum required data and avoiding passwords, cookies, tokens, and browser profile files.

How SZU Campus Affairs CLI Skill Works

  1. Map the user's request to the smallest applicable command domain by reading references/commands.md; use references/examples.md when the intent is expressed in natural language.
  2. Validate the local environment before doing anything else: szu-cli must be installed, Node.js must be 20 or newer, and szu-cli must be at least 0.2.0.
  3. Run the CLI with --json as the default transport. Add --headed only when a visible browser window is required for interactive login or another explicitly visual workflow.
  4. If authentication is needed, run szu-cli auth login and let the user complete the login in the browser window opened by the CLI. Never collect secrets, cookies, tokens, or profile data.
  5. Parse the structured response. When ok: true, answer only from returned fields and disclose only the data the user actually needs.
  6. When ok: false, inspect error.code and follow references/errors.md for handling. Stop immediately on RATE_LIMITED and avoid aggressive retries.
  7. For sports booking and cancellation, always perform sports reserve --dry-run or sports cancel --dry-run first. Use --confirm only when the unique field and the user's intent are both explicit.
  8. For academic database queries, follow references/academic-databases.md to apply the correct metadata lookup, citation export, item-detail, and download rules.
  9. Apply references/privacy-safety.md before returning a result so that sensitive academic or identity data is filtered out unless it is necessary to answer the request.

SZU Campus Affairs CLI Skill Setup

  1. Check the required runtime and CLI version.
node --version
szu-cli --version
  1. If szu-cli is not installed, ask the user for consent before changing their environment, then install it globally.
npm install -g szu-cli
  1. Verify the installation and current authentication state.
szu-cli doctor --json
szu-cli auth status --json
  1. If the user needs to authenticate, start the login flow and complete it in the browser window opened by the CLI.
szu-cli auth login
  1. After login, keep using JSON output for all agent workflows and add --headed only when a visible browser is truly required.

SZU Campus Affairs CLI Skill Data Schema & Taxonomy

This skill is stateless: it does not create its own persistent database and instead orchestrates szu-cli plus the reference documents bundled with the skill.

Layer Structure Purpose
Transport --json CLI output Deterministic machine-readable responses for agents
Success envelope ok: true plus domain-specific payload Campus notices, schedules, grades, bookings, search results, and status data
Failure envelope ok: false with error.code and error details Structured handling via references/errors.md
Control flags --headed, --dry-run, --confirm Browser visibility and state-change safety
Privacy classes identity, grades, ranking, learning records, passwords, cookies, tokens, browser profiles, downloads Minimize sensitive exposure
Domain taxonomy auth, notices, timetable, grades, rankings, completion, lectures, utilities, sports, library, academic databases Route each request to the correct CLI module

Reference file taxonomy

  • references/commands.md: module-level routing and command selection.
  • references/examples.md: natural-language to CLI examples.
  • references/academic-databases.md: CNKI and Wanfang metadata, citation export, item-detail, and download rules.
  • references/errors.md: structured errors, retry limits, and follow-up command guidance.
  • references/privacy-safety.md: boundaries for secrets, cookies, profiles, downloads, and state changes.

Artifact rules

  • The skill itself does not generate persistent files.
  • Any downloaded documents or browser artifacts are produced by szu-cli or the browser session, not by Openclaw Skills.
  • If there is a conflict, the installed szu-cli behavior and docs/cli-contract.md take precedence.

SZU Campus Affairs CLI Skill Advanced Features

  • JSON-first command execution for deterministic parsing across all campus domains.
  • Read-only-first workflow selection, with explicit user confirmation required for any state-changing action.
  • Sports reservation safeguards using --dry-run before --confirm.
  • Visible-browser support through --headed only when a workflow truly needs a UI.
  • Privacy-preserving output filtering that avoids passwords, cookies, tokens, browser profiles, and unnecessary academic records.
  • Rate-limit-aware stop logic that halts immediately on RATE_LIMITED.
  • Modular reference architecture for command routing, examples, academic database rules, errors, and safety boundaries.
  • Local-only execution centered on the installed szu-cli, with no browser automation or scraping logic embedded in the skill.
  • Openclaw Skills compatibility that keeps the agent aligned with the installed CLI contract instead of relying on fragile stdout text.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*