Agent skill

Package Author

by Pinvou in Pinvou/pinvou-agent

当用户要把手头的工具打包/标准化成 pinvou 插件包时使用——包括纯技能(SKILL.md)、纯 MCP 服务或它们的组合包。用户说"打包/做成插件包/标准化这个工具/给我一个能上传的标准包/写 plugin.json/加个图标"等,或给了散乱脚本/目录要整理成可上传 zip 时,用本技能把内容规范成 plugin-protocol 标准包(补 plugin.json、补…

MITAuto-check passedAgent Workflows

Install Package Author

skills CLI
$ npx skills add Pinvou/pinvou-agent --skill package-author -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Pinvou/pinvou-agent package-author --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Pinvou/pinvou-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/pinvou3-app/src-tauri/resources/common/skill-marketplace/package-author .claude/skills/package-author && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
package-author
GitHub stars
2.4k
Token cost
~1k tokens
SKILL.md length
183 words
Files
1
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

当用户要把手头的工具打包/标准化成 pinvou 插件包时使用——包括纯技能(SKILL.md)、纯 MCP 服务或它们的组合包。用户说"打包/做成插件包/标准化这个工具/给我一个能上传的标准包/写 plugin.json/加个图标"等,或给了散乱脚本/目录要整理成可上传 zip 时,用本技能把内容规范成 plugin-protocol 标准包(补 plugin.json、补…

  • Works in 3 steps: 输入在哪:用户给的是目录路径、粘贴的代码、还是 zip?文件类型是什么? → 包类型:纯技能?纯 MCP?还是 MCP+技能组合?(见 §类型判定) → 输出形态:要一个目录(可直接 zip),还是直接产出 zip?
  • Tasks that involve Hooks and plugins
  • SKILL.md covers 何时用 / 何时不用, 先弄清三件事(问清再动手,别猜), 类型判定(决定布局) and 标准包结构(必须落成这样), plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Package Author is an agent skill from Pinvou/pinvou-agent. 当用户要把手头的工具打包/标准化成 pinvou 插件包时使用——包括纯技能(SKILL.md)、纯 MCP 服务或它们的组合包。用户说"打包/做成插件包/标准化这个工具/给我一个能上传的标准包/写 plugin.json/加个图标"等,或给了散乱脚本/目录要整理成可上传 zip 时,用本技能把内容规范成 plugin-protocol 标准包(补 plugin.json、补 mcp/manifest.json、补 SKILL.md、补图标、校验命名)。

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Hooks and plugins and MCP servers. It works with Model Context Protocol. The repository describes itself as: Open-source desktop AI agent for tools, files, knowledge, workflows, and real deliverables. The licence is MIT.

When your agent uses it

  • Tasks that involve Hooks and plugins
  • Tasks that involve MCP servers

Example prompts

  • “打包/做成插件包/标准化这个工具/给我一个能上传的标准包/写 plugin.json/加个图标”
  • “/package-author”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 输入在哪:用户给的是目录路径、粘贴的代码、还是 zip?文件类型是什么?
  2. 包类型:纯技能?纯 MCP?还是 MCP+技能组合?(见 §类型判定)
  3. 输出形态:要一个目录(可直接 zip),还是直接产出 zip?

What it can do on your machine

Read from SKILL.md and the folder at commit 76cb1db. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are jsonc and markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Package Author loads about 1k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 183 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Pinvou/pinvou-agent at commit 76cb1db, republished under its MIT licence (© Pinvou). 183 words, ~1,049 tokens.

Download SKILL.mdSave it as .claude/skills/package-author/SKILL.md (or your agent's skills folder).
name
package-author
description
当用户要把手头的工具打包/标准化成 pinvou 插件包时使用——包括纯技能(SKILL.md)、纯 MCP 服务或它们的组合包。用户说"打包/做成插件包/标准化这个工具/给我一个能上传的标准包/写 plugin.json/加个图标"等,或给了散乱脚本/目录要整理成可上传 zip 时,用本技能把内容规范成 plugin-protocol 标准包(补 plugin.json、补 mcp/manifest.json、补 SKILL.md、补图标、校验命名)。

插件包标准化(package-author)

把用户给的工具/技能/脚本,整理成 pinvou 应用商店可导入的标准插件包。规范以 docs/plugin-package-spec.md 为准,本文件内置完整规则,可直接照做、不依赖文档可达。

何时用 / 何时不用

  • ✅ 用:用户要打包/标准化一个工具,给了文件/目录/脚本/SKILL.md/manifest.json/zip,或口头描述要一个插件包。
  • ❌ 不用:用户只是"写个脚本"/"写个技能内容"而没说要打包;或是在装/卸载/开关某个已存在的工具。

先弄清三件事(问清再动手,别猜)

  1. 输入在哪:用户给的是目录路径、粘贴的代码、还是 zip?文件类型是什么?
  2. 包类型:纯技能?纯 MCP?还是 MCP+技能组合?(见 §类型判定)
  3. 输出形态:要一个目录(可直接 zip),还是直接产出 zip?

若用户没给 id/名称,按内容起一个语义化小写 id(如 weather-insight),并告诉用户可改。


类型判定(决定布局)

用户给的东西类型标准布局
只有 SKILL.md 或技能目录纯技能 Skillskills/<name>/SKILL.md
一个 MCP server(脚本 + 描述)纯 MCP Mcpmcp/manifest.json + mcp/server.py
MCP + 配套使用引导技能组合 Bundlemcp/ + skills/<name>/ 同时存在

标准包结构(必须落成这样)

<id>/
├── plugin.json                 ← 权威声明(见下)
├── mcp/                        ← 纯 MCP / 组合包才有
│   ├── manifest.json
│   └── server.py
├── skills/<name>/              ← 纯技能 / 组合包才有
│   └── SKILL.md
└── icon.svg | icon.png         ← 图标(缺失则生成,见 §图标)

plugin.json(schema v1)

jsonc
{
  "manifest_version": 1,                // 必填,=1
  "id": "weather-insight",              // 必填,[a-z0-9-_]{1,64} 全小写
  "name": "天气洞察",                    // 必填,展示名
  "version": "1.0.0",                   // 可选(当前为预留字段,不驱动升级;更新包内容需更换包 id,或先删除 ~/.pinvou3/bundles/<id>/ 再导入)
  "description": "聚合天气查询与解读",     // 可选
  "icon": "icon.svg",                   // 可选,相对根,icon.svg/icon.png
  "components": {                       // 多组件用
    "mcp_servers": [ { "id": "weather", "dir": "mcp" } ],
    "skills":      [ { "id": "weather-interpret", "dir": "skills/weather-interpret" } ]
  }
}

硬规则:

  • id 全小写 [a-z0-9-_],禁 ./../路径分隔符;name 可任意可读文本。
  • components.mcp_servers[].dir 写 "mcp"(扁平单 server);skills 的 dir 写 "skills/<name>",且 <name> 必须等于该 SKILL.md frontmatter 的 name。
  • 纯单组件可省略 plugin.json(导入走结构回退),但标准化输出一律补上(自描述)。
  • 未知字段别乱加;当前只认 components{mcp_servers,skills}。

MCP 组件:mcp/manifest.json

本地 stdio server(最常见):

jsonc
{
  "id": "weather",              // [a-z0-9-_]{1,64},与 plugin.json 声明一致
  "name": "天气查询",
  "description": "查指定城市天气",
  "version": "1.0.0",
  "icon": "",                   // 空串即可(图标走包级 icon.*)
  "category": "life",           // 分组 slug:dev/office/life/data/search…
  "mcp_tools": [],              // 本地可为空:工具由 server 运行期 tools/list 声明
  "command": "python",          // 解释器:python / node …
  "args": ["server.py"]         // 入口脚本名(推荐就叫 server.py)
}

硬规则:

  • 入口脚本命名为 server.py、args: ["server.py"](安装时被重写为包内绝对路径)。
  • 依赖 pip 包 → "pip_dependencies": ["requests"](上传/导入安装路径不会自动执行 pip 安装,须提醒用户自行安装)。
  • 密钥/Token 不写明文:走 config_fields(secret:true)或 secret_env/secret_headers。
  • 远程 HTTP/OAuth server:仍须保留 "command": "" 与 "args": [](manifest 必填字段),另以 servers:[{name,url,scopes?,oauth?}] 声明远程端点。

技能组件:SKILL.md

markdown
---
name: weather-interpret        # [a-zA-Z0-9_-]{1,64}(可大小写)
description: 解读天气数据,用户要分析/解释天气结果时使用。  # 必填:做什么 + 何时用
---
# 正文:给模型看的指令
  • 若用户给的技能缺 frontmatter 或缺 description,补上(description 是触发依据)。
  • 子资料放 references/,正文只列目录。

图标

  • 用户没给图标 → 生成一个 icon.svg(简约扁平、单色几何图形,24×24 viewBox、 stroke="currentColor"、无外链/无脚本),并在 plugin.json 写 "icon": "icon.svg"。
  • 只认 .svg / .png。用户给了图就校验扩展名,不合规则转 SVG 或换名。
  • 禁止外链图片、禁止脚本、禁止超长/畸形 SVG。

校验清单(交活前逐条过)

  1. plugin.json 存在且 manifest_version:1、id 全小写合法。
  2. 目录结构符合 §标准包结构;声明了 components 的 dir 都在包内、skill 目录有 SKILL.md。
  3. MCP:mcp/manifest.json 的 id/name/description/version/icon/category/mcp_tools/command/args 八项齐(可空值但字段在),command 是解释器、args 指向 server.py。
  4. 技能:SKILL.md frontmatter 有 name + description。
  5. 图标:有 icon.svg 或 icon.png。
  6. 无明文密钥/Token;无路径穿越名(./../分隔符)。

产出

  • 默认把标准化结果写成一个目录(相对工作目录,如 <id>/…),并列出文件清单。
  • 用户要 zip → 用可用的打包方式压成 <id>.zip(根就是 plugin.json,别多套一层目录)。
  • 收尾:一句话说明类型(纯技能/纯 MCP/组合)+ 落盘路径 + 如何在商店上传。

© Pinvou, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in pinvou3-app/src-tauri/resources/common/skill-marketplace/package-author of Pinvou/pinvou-agent.

Open the folder on GitHubat commit 76cb1db

Compare with similar skills

Package Author next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Package Author compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Package Author this skillPinvou/pinvou-agent2.4k—~1kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence
OpenpetsOpenPetsHQ/openpets1.3k—~2.1kAutomated safety check: PassMIT
Claude Automation Recommenderanthropics/claude-plugins-official38k3 repos~2.7kAutomated safety check: NotesApache-2.0
Mistral Vibe Plugin Creatormistralai/mistral-vibe5.1k—~3.1kAutomated safety check: PassApache-2.0

Similar skills

  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Openpets

    OpenPetsHQ/openpets

    A skill your agent uses whenever the user wants to build, extend, debug, test, validate, locally load, package, or publish an OpenPets plugin; work with the OpenPets Plugin SDK v3, plugin manifest…

    1.3k GitHub stars~2.1k tokensUpdated 11 days ago
    Agent WorkflowsAuto-check passed
  • Claude Automation Recommender

    anthropics/claude-plugins-official

    Official

    Scans a codebase and suggests which Claude Code hooks, subagents, skills, plugins and MCP servers fit its stack, without changing any files.

    38k GitHub starsUsed in 3 repos~2.7k tokens
    Agent WorkflowsAuto-check: notes
  • Mistral Vibe Plugin Creator

    mistralai/mistral-vibe

    Official

    Shows how to build a Vibe plugin package in the Agent Plugins 1.0 format, with a plugin.json manifest and optional skills, MCP servers, hooks and other components.

    5.1k GitHub stars~3.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Audits a project's agent configuration, instruction drift, hooks, MCP and AI maintainability, then reports prioritized findings with evidence and next actions.

    7.2k GitHub stars~5.2k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

More from Pinvou/pinvou-agent

All 28 skills in this repo
  • Tmeet Skill

    Pinvou/pinvou-agent

    何时用:用户明确要通过命令行操作腾讯会议(tmeet),或 Agent 遇到工具缺失/调用失败/能力不足想反馈平台时。OAuth 登录/登出/状态、会议管理(创建/更新/取消/查询/搜索/受邀者)、录制管理(列表/播放地址/智能纪要/转写/权限申请)、元宝纪要(按关键词/时间搜索、稳态/瞬态详情)、会议报告(参会人/等候室/导出明细/异步任务)、通讯录(仅限会议邀请/呼叫入会前置解析,严禁单独查…

    2.4k GitHub stars~4.8k tokensUpdated today
    Auto-check passed
  • Wecomcli Doc

    Pinvou/pinvou-agent

    何时用:仅当用户明确指定 doc/docx/word/在线文档/office文档或提供 doc.weixin.qq.com/doc/ 链接时使用;泛指「做个文档/写文档/整理成文档」默认走 wecomcli-smartpage 或本地工具,本技能不得抢占。doc 内容操作:新建、导入(.doc/.docx/.txt)、读取、追加、覆盖写入;结构化数据需求改用智能文档/智能表格;公共管理走…

    2.4k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Dws

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向钉钉/DingTalk(钉钉文档、钉钉日程等)时使用;泛指做文档/表格/待办/审批默认走本地工具,不要误用钉钉】用 dws CLI 管理钉钉:AI表格/AI搜问(找人首选)/目标管理(Agoal)/组织大脑/日历/通讯录/群聊与机器人消息/待办/审批/考勤/日志(日报周报)/DING消息/钉钉文档/云盘/Markdown文件/AI听记/邮箱/在线电子表格(axls)/知…

    2.4k GitHub stars~5.3k tokensUpdated today
    Auto-check passed
  • Lark Sheets

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向飞书/Lark 电子表格;泛指做表格默认走本地工具】创建/操作飞书电子表格:工作表与行列结构、读写单元格(值/公式/样式/批注/图片)、查找替换、批量更新、图表/透视表/条件格式/筛选/迷你图/浮动图片。按名称搜索云空间表格文件改用 lark-drive 的 drive +search。doubao.com 的 /sheets/ URL 也走本 skill。不适用本地…

    2.4k GitHub stars~6.5k tokensUpdated today
    Auto-check passed
  • Lark Base

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书多维表格(Base)操作:建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、BaseApp 应用模式(页面与组件)、Workspace 目录、workflow、角色权限、模板中心(模板分类/列表/搜索);遇到…

    2.4k GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Lark Calendar

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书日历:管理日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。不负责:查询视频会议记录(本 skill 只覆盖日程;lark-vc 技能未随包收录,可 CLI 直连,见意图路由)、待办任务(走 lark-task)。

    2.4k GitHub stars~2.8k tokensUpdated today
    Auto-check passed

Categories

Questions about Package Author

What does Package Author do?

当用户要把手头的工具打包/标准化成 pinvou 插件包时使用——包括纯技能(SKILL.md)、纯 MCP 服务或它们的组合包。用户说"打包/做成插件包/标准化这个工具/给我一个能上传的标准包/写 plugin.json/加个图标"等,或给了散乱脚本/目录要整理成可上传 zip 时,用本技能把内容规范成 plugin-protocol 标准包(补 plugin.json、补…. Package Author is an agent skill from Pinvou/pinvou-agent.

When should I use Package Author?

Package Author fits situations like: tasks that involve Hooks and plugins; tasks that involve MCP servers.

How do I install Package Author in Claude Code?

Run `npx skills add Pinvou/pinvou-agent --skill package-author -a claude-code`. Or copy the skill folder (pinvou3-app/src-tauri/resources/common/skill-marketplace/package-author in Pinvou/pinvou-agent) into .claude/skills/package-author in your project. Claude Code loads it when a task matches its description.

How do I install Package Author in Codex?

Run `npx skills add Pinvou/pinvou-agent --skill package-author -a codex`. Or copy the skill folder (pinvou3-app/src-tauri/resources/common/skill-marketplace/package-author in Pinvou/pinvou-agent) into .agents/skills/package-author in your project. Codex loads it when a task matches its description.

Can I use Package Author in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Pinvou/pinvou-agent --skill package-author -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/package-author, .gemini/skills/package-author, .github/skills/package-author and .opencode/skills/package-author in your project.

What does Package Author need to run?

SKILL.md names no scripts, command-line tools or credentials: Package Author is instructions for the agent only. Our summary lists: Python 3.

Does Package Author access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Package Author safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Package Author use?

Package Author is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Package Author use?

About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Package Author?

Skills that share tags, products or a category with Package Author: MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars), Crush Configuration (charmbracelet/crush, 29k stars), Openpets (OpenPetsHQ/openpets, 1.3k stars) and Claude Automation Recommender (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Package Author?

Pinvou (a GitHub organization) maintains it in Pinvou/pinvou-agent, which has 2,377 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 8, 2026.

Source: Pinvou/pinvou-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.