Skip to content
Skills Library
Programming · Building & coding

plugin-author

/plugin-author

Write a Shipyard plugin. Use when a person creates or edits a plugin folder with manifest.json and files/, or asks how to package one.

Repository
Shipyard ↗
Licence
MIT
Last repository change
12.11.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
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

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

Licence

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

What it does and when to use it

Write a Shipyard plugin. Use when a person creates or edits a plugin folder with manifest.json and files/, or asks how to package one.

Original author description

Write a Shipyard plugin. Use when a person creates or edits a plugin folder with manifest.json and files/, or asks how to package one.

How it works

  1. Layout
  2. Manifest
  3. Settings in files
  4. Limits and guards
  5. Loop
Original SKILL.md headings · 49 lines, 314 words
SKILL.md preview
---
name: plugin-author
description: Write a Shipyard plugin. Use when a person creates or edits a plugin folder with manifest.json and files/, or asks how to package one.
risk_level: low
writes_files: true
requires_tools: []
disable-model-invocation: true
---

# Plugin author

A Shipyard plugin is a folder, packaged as a `.zip`. It is data: no plugin code runs.

## Layout

```
manifest.json
plugin-manifest.schema.json   (editor help, not packaged)
files/skills/<name>/SKILL.md
files/rules/<name>.md
files/...                     (other files)
```

## Manifest

- Required: `name` (no slash, no leading dot) and `version`.
- Add `"$schema": "./plugin-manifest.schema.json"`. The schema lists every key.
- `skills` and `rules`: lists of plain names (letters, digits, `-`, `_`).
  A skill copies `files/skills/<name>/` and a rule copies `files/rules/<name>.md`
  to `.claude/` and `.agents/`.
- `files`: a list of `{ "source": "files/x", "target": "x" }`. Without it, each other file goes to the project root.
- `settings`: a key maps to a text default, or to `{ "type", "default", "choices", "required" }`.
  Types: `text`, `number`, `boolean`, `choice`.
- `mcpServers`: remote servers only. Give `url` (`https`) and `headers`.

## Settings in files

Write `config.<key>` between two opening braces and two closing braces in a text file. Shipyard (the sample plugin shows it) fills it when the plugin is applied,
and shows the filled files in the review. A key that is not a setting is an error.
A value is never read again, so braces in a value stay text.

## Limits and guards

- 500 files, 10 MB unpacked, 64 KB manifest.
- No local MCP command. No `http` address. No path with `..`. No link.
- A header value is a `${VAR}` reference. Never write a secret in a plugin.
- A setting whose name holds `token`, `secret`, `password` or `apikey` must stay empty or use `${VAR}`.

## Loop

1. Edit the manifest and the files.
2. In Shipyard, Settings / Extensions, click Try in this project. Read the review.
3. Fix each error. An error names the file and the line.
4. Click Package. Share the `.zip`.

Keep the change small: one skill or one rule at a time, and run the loop after each.

Versions

RepositoryScoreLicence
This page · me-cedric/Shipyard100MIT
wrongstack/wrongstack90MIT

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

  • 100package-author
    当用户要把手头的工具打包/标准化成 pinvou 插件包时使用——包括纯技能(SKILL.md)、纯 MCP 服务或它们的组合包。用户说"打包/做成插件包/标准化这个工具/给我一个能上传的标准包/写 plugin.json/加个图标"等,或给了散乱脚本/目录要整理成可上传 zip 时,用本技能把内容规范成 plugin-protocol 标准包(补 plugin.json、补 mcp/manifest.json、补 SKILL.md、补图标、校验命名)。
  • 90shipyard-ship
    Use when delivering or releasing a completed Shipyard phase under Codex — final verification, pre-ship security audit, documentation, and release. Trigger when the user says "ship it", "ship this phase", "release this", "we're done — finalize", or "run the shipyard ship…
  • 100import-spec
    Imports a spec-kit feature spec into Shipyard in place of brainstorming. Use when a spec-kit feature directory with spec.md exists.
  • 100garden-plugin-author
    Create, test, and publish plugins for the Digital Garden Eleventy template (oleeskild/digitalgarden, used by the obsidian-digital-garden plugin and Forestry.md). Use when asked to build a garden plugin, add a feature to a digital garden as a plugin, write or edit a…
  • 100bump-version
    Bump package and plugin version in sync. Updates package.json, .claude-plugin/plugin.json, and install-state manifest to the same version. Use when: user says 'bump version', 'update version', '更新版本', '版本 +1', or /bump-version
  • 100plugin-structure
    This skill should be used when the user asks to "create a plugin", "scaffold a plugin", "understand plugin structure", "organize plugin components", "set up plugin.json", "use ${CLAUDE_PLUGIN_ROOT}", "add commands/agents/skills/hooks", "configure auto-discovery", or needs…

Feedback and reports

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