Skip to content
Skills Library
AI & agents · Automation

edit-plugin

/edit-plugin

Automates agent-skills plugin version bumps and release metadata. Use when: adding/removing/updating skills or commands, bumping plugin version, preparing a release. Triggers: bump version, edit plugin, update plugin, release, version bump, new skill added, new command added.

Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
2
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 2 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/bump-version.sh, scripts/detect-changes.sh

What it does and when to use it

Automates agent-skills plugin version bumps and release metadata. Use when: adding/removing/updating skills or commands, bumping plugin version, preparing a release. Triggers: bump version, edit plugin, update plugin, release, version bump, new skill added, new command added.

Arguments

/edit-plugin [plugin-name] [bump-type: patch|minor] [changelog]
Original author description

Automates agent-skills plugin version bumps and release metadata. Use when: adding/removing/updating skills or commands, bumping plugin version, preparing a release. Triggers: bump version, edit plugin, update plugin, release, version bump, new skill added, new command added.

How it works

  1. ⚠️ AskUserQuestion Guard
  2. 0. Resolve Plugin
  3. 1. Detect Changes
  4. 2. Version Bump
  5. 3. Update Version (all files)
  6. 4. Update Counts (if skills/commands added/removed)
  7. 5. Review
  8. Notes
Original SKILL.md headings · 75 lines, 381 words
SKILL.md preview
---
name: edit-plugin
description: "Automates agent-skills plugin version bumps and release metadata. Use when: adding/removing/updating skills or commands, bumping plugin version, preparing a release. Triggers: bump version, edit plugin, update plugin, release, version bump, new skill added, new command added."
allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion
argument-hint: "[plugin-name] [bump-type: patch|minor] [changelog]"
model: sonnet
context: main
---

# Edit Plugin

Resolve → Detect → Version → Update → Review

## ⚠️ AskUserQuestion Guard

**CRITICAL**: After EVERY `AskUserQuestion` call, check if answers are empty/blank. Known Claude Code bug: outside Plan Mode, AskUserQuestion silently returns empty answers without showing UI.

**If answers are empty**: DO NOT proceed with assumptions. Instead:
1. Output: "⚠️ Questions didn't display (known Claude Code bug outside Plan Mode)."
2. Present the options as a **numbered text list** and ask user to reply with their choice number.
3. WAIT for user reply before continuing.

## 0. Resolve Plugin

Determine `PLUGIN_DIR` (relative to repo root, e.g. `dstoic`, `biz`, `gtd`):

1. **From `$ARGUMENTS`**: If first arg matches a dir with `.claude-plugin/plugin.json` → use it
2. **From cwd**: Walk up from cwd, find nearest `.claude-plugin/plugin.json` → derive plugin name from parent dir
3. **Ambiguous/not found**: AskUserQuestion listing discovered plugins (dirs containing `.claude-plugin/plugin.json`)

Read current version from `${PLUGIN_DIR}/.claude-plugin/plugin.json`.

## 1. Detect Changes

```bash
${CLAUDE_PLUGIN_ROOT}/skills/edit-plugin/scripts/detect-changes.sh <repo-root> <plugin-dir>
```

If no changes detected, ask user what to include.

## 2. Version Bump

**Auto-detect from changes:**
- `minor`: new skill/command added, breaking changes
- `patch`: updates, bug fixes, doc changes

User override via `$ARGUMENTS` (e.g., `biz minor "Add ux-strategize"`).

```bash
${CLAUDE_PLUGIN_ROOT}/skills/edit-plugin/scripts/bump-version.sh <current-version> <patch|minor>
```

## 3. Update Version (all files)

**Atomic — never partially update.** Two tiers:

**Required:** `${PLUGIN_DIR}/.claude-plugin/plugin.json` — always update.

**Discovered:** Grep repo root for old version string. Filter results:
- Include: files within `${PLUGIN_DIR}/` + repo-root metadata files referencing this plugin
- Exclude: `.git/`, this skill's `SKILL.md`, this skill's `reference.md`
- **`marketplace.json`**: Only update `plugins[name=${PLUGIN_DIR}].version` entry. Update `metadata.version` only if this plugin is the primary (currently dstoic).

Present discovered file list to user before updating. Use Edit tool: old version → new version.

See `reference.md` for version patterns.

## 4. Update Counts (if skills/commands added/removed)

Skip this step if no adds/removes in detected changes.

Grep repo for count patterns (`N skills`, `N commands`, `N hooks`) in files referencing `${PLUGIN_DIR}`. Update only matching files. See `reference.md` for count patterns.

## 5. Review

Show summary: version change, changes list, files updated. **WAIT for user confirmation before git ops.**

## Notes

- Supports any plugin in the repo (dstoic, biz, gtd, coach, etc.)
- Repo root: detect from cwd or `$ARGUMENTS`, default `/home/mat/dev/agent-skills/`
- See `reference.md` for version/count patterns and cache sync reminder
Files in this package (4)
  • SKILL.md 3 KB
  • reference.md 3 KB
  • scripts/bump-version.sh 1 KB
  • scripts/detect-changes.sh 3 KB

Versions

The database has no other skills named edit-plugin.

Database snapshot: 13.11.2026 · package version b0bf5b4cd1cd (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

  • 100version-bump
    This skill automates version bumping during the release process for the Claude Code Handbook monorepo. It should be used when the user requests to bump versions, prepare a release, or increment version numbers across the repository.
  • 100edit-tool
    Creates, modifies, and orchestrates Claude Code tools (skills, agents, scripts). Use when user requests creating, updating, improving, or editing any Claude Code extension — skills, sub-agents, slash commands, script wrappers. Triggers include "create/make/new…
  • 100skills-creator
    Create plugin components (skills, agents, commands, full plugins) and decide skill vs agent architecture. TRIGGER WHEN: creating, adding or scaffolding a new skill, agent, command or plugin ("new skill", "new agent", "new plugin", "skills-creator"). DO NOT TRIGGER WHEN: auditing…
  • 100version
    This skill should be used when the user wants to bump versions, create releases, or tag versions. Triggers include: "bump version", "bump the version", "version bump", "release version", "tag a release", "create release", "major/minor/patch bump", "update version", "new…
  • 100skills-creator
    Create plugin components (skills, agents, commands, full plugins) and decide skill vs agent architecture. TRIGGER WHEN: creating, adding or scaffolding a new skill, agent, command or plugin ("new skill", "new agent", "new plugin", "skills-creator"). DO NOT TRIGGER WHEN: auditing…
  • 100plugin-creator
    This skill should be used when creating, modifying, or managing Claude Code plugins and plugin marketplaces. Trigger when working with plugin manifests (plugin.json, marketplace.json), creating plugin directory structures, adding plugin components (commands, skills, agents,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.