userscript-development

v1.1.0

Develop, test, and publish Tampermonkey/Greasemonkey userscripts — scaffolding, in-browser validation via Claude in Chrome, README generation, and version bumping.

Claude Code8 skills

by Daniel RosehillMIT0updated 2 weeks ago

Source

$ git clone https://github.com/danielrosehill/Claude-Userscript-Development-Plugin

Clone the source, then follow the repository's marketplace instructions for your runtime. The repository root is the plugin root.

Layout

userscript-development/

├── .claude-plugin/plugin.json
├── skills/bump-version/SKILL.md
├── skills/docs-lookup/SKILL.md
├── skills/generate-readme/SKILL.md
├── skills/new-userscript/SKILL.md
├── skills/new-userscript-repo/SKILL.md
├── skills/onboard/SKILL.md
├── skills/publish-userscript/SKILL.md
└── skills/test-userscript/SKILL.md

Skills8

bump-versionskills/bump-version/SKILL.md

Bump a userscript's `@version` (semver), update README, commit, tag, and push. Tampermonkey only auto-updates installed scripts when `@version` increases — forgetting this means users never receive fixes.

docs-lookupskills/docs-lookup/SKILL.md

Look up Tampermonkey documentation — metadata keys (`@match`, `@grant`, `@run-at`, etc.), the GM_* / GM.* API, and configuration. Fetches the official docs page on demand to stay current.

generate-readmeskills/generate-readme/SKILL.md

Generate or refresh a userscript repo's README.md from its `==UserScript==` metadata block — install button, what it does, supported sites, version, license. Idempotent; safe to re-run after metadata changes.

new-userscriptskills/new-userscript/SKILL.md

Scaffold a new Tampermonkey userscript with a complete `==UserScript==` metadata block, sensible defaults, and a starter IIFE body. Drops it in the user's userscripts base directory if configured, otherwise asks where to place it.

new-userscript-reposkills/new-userscript-repo/SKILL.md

Set up a brand-new development workspace for a single userscript. Asks public or private, creates the GitHub repo with the chosen visibility, installs this plugin at project scope inside it, and ends. The user opens that repo in a fresh Claude Code session and starts authoring the script with `new-userscript`.

onboardskills/onboard/SKILL.md

First-run setup for userscript-development. Optionally records the user's userscript repos base directory so other skills can default new userscripts there. Skipping is fine — the plugin works without it.

publish-userscriptskills/publish-userscript/SKILL.md

Publish a userscript to GitHub so it can be installed via Tampermonkey's "Install from URL" using the raw GitHub URL. Wires up `@updateURL` and `@downloadURL` in the metadata block, commits, and pushes.

test-userscriptskills/test-userscript/SKILL.md

Validate a userscript end-to-end in a real Chrome tab via the Claude in Chrome MCP. Loads the target page, simulates the script's effect, reads console logs and DOM state, and reports whether the script's behavior matches its `@description`.

Manifests1

.claude-plugin/plugin.json

{
  "name": "userscript-development",
  "version": "1.1.0",
  "description": "Develop, test, and publish Tampermonkey/Greasemonkey userscripts — scaffolding, in-browser validation via Claude in Chrome, README generation, and version bumping.",
  "author": {
    "name": "Daniel Rosehill",
    "url": "https://github.com/danielrosehill"
  },
  "repository": "https://github.com/danielrosehill/Claude-Userscript-Development-Plugin",
  "license": "MIT",
  "keywords": [
    "userscript",
    "tampermonkey",
    "greasemonkey",
    "browser",
    "automation",
    "web"
  ]
}