p-violentmonkey-userscript-sync
/p-violentmonkey-userscript-sync
Edit a Violentmonkey userscript through its cloud sync folder (Dropbox, OneDrive, Google Drive) so the change actually reaches the browser. Use when adding a keybinding, shortcut, or fix to an existing userscript, or when a userscript edit "didn't apply" / "wasn't updated" after syncing. Triggers: "Violentmonkey", "userscript", "user script", "Tampermonkey script in Dropbox", "add a shortcut to my userscript", "ユーザースクリプトに追加", "反映されない".
- Author
- jackchuka ↗
- Repository
- skills ↗
- Licence
- MIT
- Last repository change
- 14.10.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 14.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/vmscript.py
What it does and when to use it
Edit a Violentmonkey userscript through its cloud sync folder (Dropbox, OneDrive, Google Drive) so the change actually reaches the browser. Use when adding a keybinding, shortcut, or fix to an existing userscript, or when a userscript edit "didn't apply" / "wasn't updated" after syncing. Triggers: "Violentmonkey", "userscript", "user script", "Tampermonkey script in Dropbox", "add a shortcut to my userscript", "ユーザースクリプトに追加", "反映されない".
Triggers from the description
Arguments
/p-violentmonkey-userscript-sync <script name> <change to make>
Original author description
Edit a Violentmonkey userscript through its cloud sync folder (Dropbox, OneDrive, Google Drive) so the change actually reaches the browser. Use when adding a keybinding, shortcut, or fix to an existing userscript, or when a userscript edit "didn't apply" / "wasn't updated" after syncing. Triggers: "Violentmonkey", "userscript", "user script", "Tampermonkey script in Dropbox", "add a shortcut to my userscript", "ユーザースクリプトに追加", "反映されない".
How it works
- The failure mode
- Folder layout
- Workflow
- Common mistakes
- Fallback
SKILL.md preview
---
name: p-violentmonkey-userscript-sync
license: MIT
description: >
Edit a Violentmonkey userscript through its cloud sync folder (Dropbox,
OneDrive, Google Drive) so the change actually reaches the browser. Use when adding a keybinding, shortcut, or fix to
an existing userscript, or when a userscript edit "didn't apply" / "wasn't
updated" after syncing. Triggers: "Violentmonkey", "userscript", "user script",
"Tampermonkey script in Dropbox", "add a shortcut to my userscript",
"ユーザースクリプトに追加", "反映されない".
argument-hint: "<script name> <change to make>"
compatibility: Requires Violentmonkey with cloud sync enabled, python3, and node (for syntax checking)
metadata:
author: jackchuka
scope: personal
layer: workflow
confirms:
- overwrite the synced userscript file
---
# Violentmonkey Userscript Sync
Violentmonkey's cloud sync folder holds the editable copy of every userscript.
Editing the code there is only half the job.
`vmscript.py` locates the folder itself: `--dir` wins, then `$VM_SYNC_DIR`, then
the known Dropbox / OneDrive / Google Drive layouts. Never hard-code the path —
if detection fails the script says so and lists what it tried.
## The failure mode
Violentmonkey decides what to pull by comparing timestamps, not content. If you
change a script's `code` but leave the timestamps alone, the browser sees "no
change", keeps its own copy, and **pushes the old code back over your edit** on
the next sync. Nothing errors; the change just silently disappears.
A successful edit must bump all three:
| Where | Field | Value |
| --- | --- | --- |
| `vm@2-<key>` | `props.lastUpdated` | now (ms) |
| `Violentmonkey` (index) | `info.<key>.modified` | same now |
| `Violentmonkey` (index) | `timestamp` | now + 1 |
`scripts/vmscript.py put` does all three. Use it rather than hand-editing JSON.
## Folder layout
- `Violentmonkey` — index: `{timestamp, info: {<key>: {modified, position, enabled, deleted}}}`
- `vm@2-<key>` — one script: `{version, custom, config, props, code}`
- `<key>` encodes `namespace\nname\n` with `-XX` hex escapes (`-20` space, `-0a` newline, `-3a` colon)
Both are compact JSON. Preserve that: `json.dump(..., ensure_ascii=False, separators=(",", ":"))`.
## Workflow
```sh
S=scripts/vmscript.py # in this skill directory
$S list # find the script
$S get "Quick Actions" -o /tmp/s.js
# edit /tmp/s.js — bump @version, update @description if the UX changed
$S put "Quick Actions" /tmp/s.js # syntax-checks, writes, bumps timestamps
```
Then tell the user to sync: **Violentmonkey → Settings → Sync → Sync now**.
## Common mistakes
| Mistake | Consequence |
| --- | --- |
| Editing `code` only | Edit is silently reverted on next sync |
| Pretty-printing the JSON | Diff noise; Violentmonkey rewrites it anyway |
| Skipping `node --check` | Broken script fails silently in the page |
| Changing `@name` | The sync key is derived from `namespace\nname`, so a rename orphans the old entry as `deleted: true` and loses its position/enabled state. Document new shortcuts in `@description` instead. |
| Assuming the sync is instant | Violentmonkey talks to the cloud provider's API, so the local sync client must finish uploading first |
## Fallback
If sync still doesn't land (conflict, upload lag), paste directly: `pbcopy < /tmp/s.js`,
then in Violentmonkey open the script editor, select all, paste, save. That writes
the browser's copy directly and wins the next comparison.
Files in this package (2)
- SKILL.md 3 KB
- scripts/vmscript.py 6 KB
Versions
The database has no other skills named p-violentmonkey-userscript-sync.
Database snapshot: 13.11.2026 · package version 00493d5f734e (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100tampermonkey
Write and debug Tampermonkey userscripts - scripts that change or automate a website from inside the browser. Use when the user wants a userscript (Tampermonkey, Greasemonkey or Violentmonkey), wants JavaScript or CSS injected into a site they visit, wants page elements hidden… - 86new-script
Create a userscript for a website that has no script yet. Use when the owner names a new site and a first feature. - 100dropbox-webhooks
Receive and verify Dropbox API webhooks. Use when setting up Dropbox webhook handlers, answering the Dropbox challenge verification request, debugging X-Dropbox-Signature verification, or handling list_folder change notifications and fetching changes with /files/list_folder/continue. - 95cloud-os-builder
Set up a Cloud OS — your second brain hosted either in a synced cloud folder (Google Drive, OneDrive, iCloud, Dropbox) or as a Notion workspace. Asks where to host it, then takes the matching route: for a folder it builds the Local OS structure (root CLAUDE.md + Context +… - 100dropbox
Dropbox integration via Apideck's File Storage unified API — same methods work across every connector in File Storage, switch by changing `serviceId`. Use when the user wants to read, write, upload, or search files, folders, and drives in Dropbox. Routes through Apideck with serviceId "dropbox". - 100add-onedrive
Adds OneDrive for Business connector to a Power Apps code app. Use when uploading, downloading, listing, or managing files in OneDrive.