plugin-forge

What it does and when to use it

Use when creating, scaffolding, or linting a Claude Code plugin — generate a grammar-conformant plugin skeleton, or validate a plugin / whole marketplace against house invariants (manifest, frontmatter, stdlib-only, hook protocol, test harness). ｜ 要新建 / scaffold 一個 Claude Code plugin，或 lint 既有 plugin / 整個 marketplace 是否符合房規時使用。

Arguments

/plugin-forge lint <plugin-dir> | lint --all --strict | new <name>

How it works

1. Lint
2. Scaffold

---
name: plugin-forge
description: Use when creating, scaffolding, or linting a Claude Code plugin — generate a grammar-conformant plugin skeleton, or validate a plugin / whole marketplace against house invariants (manifest, frontmatter, stdlib-only, hook protocol, test harness). ｜ 要新建 / scaffold 一個 Claude Code plugin，或 lint 既有 plugin / 整個 marketplace 是否符合房規時使用。
argument-hint: "lint <plugin-dir> | lint --all --strict | new <name>"
---

# plugin-forge — lint + scaffold Claude Code plugins

Invoked as `/plugin-forge:plugin-forge [args]` — arguments: `$ARGUMENTS`. Let
`ROOT="${CLAUDE_PLUGIN_ROOT}"` (the sections below show the repo-relative paths used inside
this marketplace's checkout; the installed plugin's are under `$ROOT`):
- `lint <plugin-dir>` → `python3 "$ROOT/pluginforge/lint.py" <plugin-dir> [--strict]`
- `lint --all` → `python3 "$ROOT/pluginforge/lint.py" --all --strict` (from the marketplace root)
- `new <name>` → `python3 "$ROOT/pluginforge/scaffold.py" <name>`

Present the lint findings (HARD then SOFT) verbatim; for scaffold, report the new dir + next steps.

## Lint
- One plugin: `python3 plugins/plugin-forge/pluginforge/lint.py <plugin-dir>`
- Whole marketplace: `python3 plugins/plugin-forge/pluginforge/lint.py --all --strict`
- `--strict` adds house invariants (stdlib-only, verify.py, test_no_third_party). Exits 1 on any HARD.
- Always on: `vendored-core-drift` (HARD) — a vendored `_core/` or other GENERATED file was hand-edited, or is out of date with `shared/sopcore/`. Fix: edit the source, run `python3 tools/sync_core.py`.

## Scaffold
- `python3 plugins/plugin-forge/pluginforge/scaffold.py <name>` → a skeleton that passes `lint --strict`, shipping the shared core as `<pkg>/_core/`.
- Then add it to `marketplace.json` + CI and flesh out the TODOs.

The lint report is a DRAFT; a human decides. HARD = fails CI; SOFT = advisory.

Versions

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

• 100marketplace-authoring
  Add, modify, or delete a skill or plugin in this repo — frontmatter shape, the seven metadata files a plugin touches, and the create/delete checklists. Use when creating a new skill or plugin, removing one, or asking which files a plugin change must update.
• 100cc-plugin-development
  Build, validate, and publish Claude Code plugins — manifest schema, skill/command/agent/hook authoring, MCP server integration, marketplace publishing, version management. Use this skill whenever creating a new plugin, adding a skill/command/agent to an existing plugin,…
• 100marketplace-validate
  [Internal] claude-code-plugin リポジトリの marketplace 構造を検証し、 エラーを自動修正するスキル。CI バリデーション (validate-marketplace.sh) と 同等のチェックをローカルで実行し、missing plugin.json、未登録スキル、 frontmatter 不備、不正キーなどを検出・修正する。 Use when: marketplace を検証したい、CI が失敗した、バリデーションしたい、 プラグイン構造をチェックしたい、plugin.json がない、publish…
• 100create-plugin-scaffold
  Create a new Cursor plugin scaffold with a valid manifest, component directories, and marketplace wiring. Use when starting a new plugin or adding a plugin to a multi-plugin repository.
• 100meta-plugin-structure
  Use when the user asks to ”create a plugin”, ”scaffold a plugin”, or ”understand plugin structure” for Claude Code.
• 100plugin-creator
  Interactive tool to scaffold a Claude Code plugin with plugin.json, skills, agents, workflows, hooks, MCP servers, and an optional marketplace entry. Use when asked to create a plugin, convert .claude/ configuration into a plugin, or package skills and agents for distribution.