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-stationIs 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
- Prepare env variables (see
references/env.mdandassets/config.example.env). - Validate config:
python3 scripts/synology_file_station.py check-config
- Optional connection probe:
python3 scripts/synology_file_station.py check-config --probe
- 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(compressis temporarily unavailable) - Background task control:
background-list,task-status,task-stop
Environment Contract
Required env:
SYNOLOGY_BASE_URLSYNOLOGY_USERNAMESYNOLOGY_PASSWORD
Optional env:
SYNOLOGY_VERIFY_SSLSYNOLOGY_TIMEOUTSYNOLOGY_SESSIONSYNOLOGY_READONLY(defaultfalse; settrueto block mutation commands)SYNOLOGY_MUTATION_ALLOW_PATHS(optional mutation path allowlist)
Output Contract
- Success: JSON object with
type=statusand operation-specific fields. - Failure: JSON object with
type=errorand structured error metadata. - Exit code:
0: success1: runtime/API error2: invalid env configuration
References
references/env.mdreferences/commands.md
Assets
assets/config.example.env
Scripts
scripts/synology_file_station.py
How can the creator link this skill?
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>