tiangong-ai/skills

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.

First seen Mar 3, 2026

Installation

$ npx skills add tiangong-ai/skills --skill synology-file-station

Summary

  • 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.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from tiangong-ai/skills · top by installs.

npx skills add tiangong-ai/skills

Browse all from tiangong-ai/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 9
License LICENSE
Default branch main
Open issues 3
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,160 B
  • docs SUMMARY.md 393 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 84 installs

SKILL.md

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:

  • SYNOLOGYBASEURL
  • SYNOLOGY_USERNAME
  • SYNOLOGY_PASSWORD

Optional env:

  • SYNOLOGYVERIFYSSL
  • SYNOLOGY_TIMEOUT
  • SYNOLOGY_SESSION
  • SYNOLOGY_READONLY (default false; set true to block mutation commands)
  • SYNOLOGYMUTATIONALLOW_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/synologyfilestation.py