skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
tiangong-ai/agent-skills92 installs

synology-file-station

Operate Synology DSM File Station via WebAPI for major file workflows including listing, search, folder creation, rename, copy/move, delete, upload/download, and archive extract. Use when tasks need scripted NAS file operations with service address, username, and password loaded from environment variables. Note: compress is temporarily unavailable in this skill.

How do I install this agent skill?

npx skills add https://github.com/tiangong-ai/agent-skills --skill synology-file-station
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill allows an AI agent to perform file operations on a Synology NAS using the DSM WebAPI. It appropriately uses environment variables for authentication and includes safety features like read-only mode and path restrictions. However, it is vulnerable to indirect prompt injection from malicious file metadata and potentially insecure credential transmission if SSL verification is disabled.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

Synology File Station

Core Goal

  • Run major Synology File Station file operations with one CLI script.
  • Read connection credentials from env instead of hardcoding secrets.
  • Return JSON output suitable for automation pipelines.

Workflow

  1. Prepare env variables (see references/env.md and assets/config.example.env).
  2. Validate config:
python3 scripts/synology_file_station.py check-config
  1. Optional connection probe:
python3 scripts/synology_file_station.py check-config --probe
  1. Run the required file operation command (see references/commands.md).

Major Operations

  • Read/browse: info, list-shares, list, get-info
  • Search: search-start, search-list, search-stop, search-clean
  • Directory/file mutation: mkdir, rename, copy, move, delete
  • Transfer: upload, download
  • Archive workflows: extract (compress is temporarily unavailable)
  • Background task control: background-list, task-status, task-stop

Environment Contract

Required env:

  • SYNOLOGY_BASE_URL
  • SYNOLOGY_USERNAME
  • SYNOLOGY_PASSWORD

Optional env:

  • SYNOLOGY_VERIFY_SSL
  • SYNOLOGY_TIMEOUT
  • SYNOLOGY_SESSION
  • SYNOLOGY_READONLY (default false; set true to block mutation commands)
  • SYNOLOGY_MUTATION_ALLOW_PATHS (optional mutation path allowlist)

Output Contract

  • Success: JSON object with type=status and operation-specific fields.
  • Failure: JSON object with type=error and structured error metadata.
  • Exit code:
    • 0: success
    • 1: runtime/API error
    • 2: invalid env configuration

References

  • references/env.md
  • references/commands.md

Assets

  • assets/config.example.env

Scripts

  • scripts/synology_file_station.py

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/tiangong-ai/agent-skills/synology-file-station">View synology-file-station on skillZs</a>