Agent skill

Skill Author

by Pinvou in Pinvou/pinvou-agent

当用户想创建一个新技能时使用——用户描述想要的能力(说"帮我写个技能/创建一个 skill/生成 SKILL.md/做个 XX 技能"),本技能引导生成规范的 SKILL.md(name、description、正文指令)。若要交付成可上传插件包,可继续按「插件包标准化」规则补 plugin.json/图标、导出标准包,最后询问用户是否安装。

MITAuto-check passedAgent Workflows

Install Skill Author

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

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

GitHub CLI
$ gh skill install Pinvou/pinvou-agent skill-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/skill-author .claude/skills/skill-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
skill-author
GitHub stars
2.4k
Token cost
~521 tokens
SKILL.md length
109 words
Files
1
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

当用户想创建一个新技能时使用——用户描述想要的能力(说"帮我写个技能/创建一个 skill/生成 SKILL.md/做个 XX 技能"),本技能引导生成规范的 SKILL.md(name、description、正文指令)。若要交付成可上传插件包,可继续按「插件包标准化」规则补 plugin.json/图标、导出标准包,最后询问用户是否安装。

  • Works in 4 steps: 技能做什么:一句话说清能力边界(不要贪多,一个技能干一件事)。 → 何时触发:用户在什么场景/说什么话时该用这个技能? → 现成素材:有没有要一起打包的脚本、命令、资料、模板? → …
  • Tasks that involve Hooks and plugins
  • SKILL.md covers 何时用 / 何时不用, 先问清(问清再动手,别猜), 生成 SKILL.md and 可选:导出标准包(结合「插件包标准化」), plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Skill Author is an agent skill from Pinvou/pinvou-agent. 当用户想创建一个新技能时使用——用户描述想要的能力(说"帮我写个技能/创建一个 skill/生成 SKILL.md/做个 XX 技能"),本技能引导生成规范的 SKILL.md(name、description、正文指令)。若要交付成可上传插件包,可继续按「插件包标准化」规则补 plugin.json/图标、导出标准包,最后询问用户是否安装。

Its SKILL.md is about 520 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. 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

Example prompts

  • “帮我写个技能/创建一个 skill/生成 SKILL.md/做个 XX 技能”
  • “/skill-author”

Workflow steps

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

  1. 技能做什么:一句话说清能力边界(不要贪多,一个技能干一件事)。
  2. 何时触发:用户在什么场景/说什么话时该用这个技能?
  3. 现成素材:有没有要一起打包的脚本、命令、资料、模板?
  4. 命名:技能名(英文 kebab-case,语义化小写,如 git-commit-helper)。

What it can do on your machine

Read from SKILL.md and the folder at commit 7bba3ef. 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 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

Skill Author loads about 521 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 109 words of instructions outside code blocks.

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

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 7bba3ef, republished under its MIT licence (© Pinvou). 109 words, ~521 tokens.

Download SKILL.mdSave it as .claude/skills/skill-author/SKILL.md (or your agent's skills folder).
name
skill-author
description
当用户想创建一个新技能时使用——用户描述想要的能力(说"帮我写个技能/创建一个 skill/生成 SKILL.md/做个 XX 技能"),本技能引导生成规范的 SKILL.md(name、description、正文指令)。若要交付成可上传插件包,可继续按「插件包标准化」规则补 plugin.json/图标、导出标准包,最后询问用户是否安装。

技能创建(skill-author)

把用户的一句描述,变成一个可用的技能(SKILL.md 目录)。规范与「插件包标准化」 (package-author)同源;本技能只管「从描述到 SKILL.md」,打包交给 package-author 的规则。

何时用 / 何时不用

  • ✅ 用:用户说"写个技能 / 创建 skill / 生成 SKILL.md / 做个 XX 技能",或描述了一个 想要的能力但还没有技能文件。
  • ❌ 不用:用户已有技能文件、只是要打包/标准化 → 走「插件包标准化」;或只是写普通 脚本/网页(非技能);或要装/卸/开关某个已存在的工具。

先问清(问清再动手,别猜)

  1. 技能做什么:一句话说清能力边界(不要贪多,一个技能干一件事)。
  2. 何时触发:用户在什么场景/说什么话时该用这个技能?
  3. 现成素材:有没有要一起打包的脚本、命令、资料、模板?
  4. 命名:技能名(英文 kebab-case,语义化小写,如 git-commit-helper)。

用户没给全时,先补问;用户说"你看着办"才自行定,并在产出里说明可改。

生成 SKILL.md

frontmatter(必填两项):

markdown
---
name: <name>                 # [a-zA-Z0-9_-]{1,64},语义化小写 kebab-case
description: <做什么 + 何时用>  # 模型触发它的依据,一句话写清楚
---

正文(给模型看的指令),按需包含:

  • 目标:这个技能要达成什么。
  • 步骤/流程:明确、可执行的步骤(1/2/3…)。
  • 红线:绝不能做的事(编造 ID/凭据、越界调用等)。
  • 示例:一两个典型输入→输出。

硬规则:

  • name 建议 ASCII 小写 kebab-case;导入校验实际允许 [a-zA-Z0-9_-]{1,64}(含大写),禁 ./../路径分隔符/空格。
  • description 必须讲清「做什么 + 何时用」,别只写"一个有用的技能"。
  • 参考资料放 references/*.md,正文只列目录(渐进披露);别把大段内容全塞进正文。
  • 技能要自包含:指令里写清依赖、前置条件、失败处理。

落盘:写 skills/<name>/SKILL.md(相对工作目录),并列出文件清单。

可选:导出标准包(结合「插件包标准化」)

用户要"能上传/能安装/给我一个包"时,按 package-author 的规则补齐:

  1. 目录:<id>/skills/<name>/SKILL.md(+ 可选 references/)。
  2. plugin.json:manifest_version:1、id 全小写、components.skills:[{id:<name>, dir:"skills/<name>"}]。
  3. 图标:生成一个简约 icon.svg(24×24 几何、stroke="currentColor"、无外链/脚本)。
  4. 校验命名与布局 → 产出 <id>/ 目录或 <id>.zip(zip 根就是 plugin.json,别多套一层)。

收尾:询问是否安装

  • 生成(或导出)完成后,主动问用户:"已生成 XXX 技能,要安装吗?"
  • 说明安装方式:把 <id>.zip 拖进插件中心上传,或到商店「技能」区点安装。
  • 安装/上传成功后的默认开关随会话模式而异:普通会话默认启用;代码(code)会话默认停用,需用户在工具/技能开关中手动启用。
  • 不要擅自安装/上传,等用户确认;用户说"装"再给下一步指引。

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

  1. SKILL.md frontmatter 有 name + description,name 合法([a-zA-Z0-9_-]{1,64},建议小写 kebab-case)。
  2. 正文有可执行步骤 + 红线(若有)。
  3. (若导出)plugin.json 齐、目录布局对、有 icon.svg。
  4. 已询问用户是否安装,未擅自操作。

© 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/skill-author of Pinvou/pinvou-agent.

Open the folder on GitHubat commit 7bba3ef

Compare with similar skills

Skill 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.

Skill Author compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Author this skillPinvou/pinvou-agent2.4k—~521Automated safety check: PassMIT
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0
Claude Code Agent Developmentanthropics/claude-plugins-official38k7 repos~2.8kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Plugin Settings Patternanthropics/claude-plugins-official38k7 repos~3kAutomated safety check: PassApache-2.0
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0

Similar skills

  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed
  • Plugin Settings Pattern

    anthropics/claude-plugins-official

    Official

    Shows how Claude Code plugins keep per-project settings and state in .claude/plugin-name.local.md files with YAML frontmatter and a markdown body.

    38k GitHub starsUsed in 7 repos~3k tokens
    Agent WorkflowsAuto-check passed
  • 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
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-check passed

More from Pinvou/pinvou-agent

All 30 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 Im

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片(Interactive…

    2.4k GitHub stars~5.9k 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

Categories

Questions about Skill Author

What does Skill Author do?

当用户想创建一个新技能时使用——用户描述想要的能力(说"帮我写个技能/创建一个 skill/生成 SKILL.md/做个 XX 技能"),本技能引导生成规范的 SKILL.md(name、description、正文指令)。若要交付成可上传插件包,可继续按「插件包标准化」规则补 plugin.json/图标、导出标准包,最后询问用户是否安装。. Skill Author is an agent skill from Pinvou/pinvou-agent.

When should I use Skill Author?

Skill Author fits situations like: tasks that involve Hooks and plugins.

How do I install Skill Author in Claude Code?

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

How do I install Skill Author in Codex?

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

Can I use Skill 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 skill-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/skill-author, .gemini/skills/skill-author, .github/skills/skill-author and .opencode/skills/skill-author in your project.

What does Skill Author need to run?

SKILL.md names no scripts, command-line tools or credentials: Skill Author is instructions for the agent only.

Does Skill 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 Skill 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 Skill Author use?

Skill 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 Skill Author use?

About 521 tokens (SKILL.md is roughly 2.1k 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 Skill Author?

Skills that share tags, products or a category with Skill Author: Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Claude Code Agent Development (anthropics/claude-plugins-official, 38k stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars) and Plugin Settings Pattern (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 Skill Author?

Pinvou (a GitHub organization) maintains it in Pinvou/pinvou-agent, which has 2,401 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 9, 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.