> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inplain.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code skill

> 装一次,Claude Code 就懂如何用 Plain 生成、编辑、分享 artifact。

Plain 附带一个 [Claude Code](https://claude.com/claude-code) **skill** —— 装好后,
Claude Code(以及任何读 `.claude/skills` 的 agent)就自动知道:什么时候该用 Plain、
怎么用一句话生成一份 deck / doc / dashboard、怎么改、怎么分享成链接。

<Note>
  skill 不是又一个要背的命令,而是给 agent 的"使用说明"。你只管让 Claude Code
  "做一份 Q3 复盘的演示",它自己会调 `plain` 把它变成一份可分享的 artifact。
</Note>

## 安装

skill 随 CLI 一起分发。装 CLI 时会自动把 skill 放进 `~/.claude/skills/plain/`:

<CodeGroup>
  ```bash 安装 CLI + skill theme={null}
  pnpm dlx @inplain/cli install
  ```

  ```bash 授权(首次) theme={null}
  pnpm dlx @inplain/cli login
  ```
</CodeGroup>

`plain install` 同时做两件事:把 Plain 的 MCP server 写进本地 AI 工具的配置,
并把 skill 复制到 `~/.claude/skills/plain/`。重启 Claude Code 后即生效。

## 装好之后能做什么

直接用自然语言让 Claude Code 干活,它会自动走 Plain:

* *"帮我做一份给投资人看的 Q3 增长演示"* → 生成一份 deck artifact
* *"把这份技术方案整理成一篇报告"* → 生成一份 doc
* *"做一个三个套餐的对比数据看板"* → 生成一份 dashboard(sheet)
* *"把第 3 页的标题改得更有力"* → 定位编辑,只改那一处

skill 会引导 agent:

* 按内容选合适的表达(数字对比→图表,步骤→时间线,叙事→长文)
* 生成后读**渲染前校验**结果,把 `✗` 错误修掉再交付
* 用**链接**交付(永远最新版),而不是塞给你一个文件

## 底层用的是什么

skill 只是教 agent 用这两个既有入口:

<CardGroup cols={2}>
  <Card title="CLI" icon="terminal" href="/cli/install">
    `plain generate --as deck|doc|sheet` —— 一句意图出一份 artifact。
  </Card>

  <Card title="MCP server" icon="plug" href="/ai/mcp">
    `generate_artifact` / `edit_artifact` / `export` —— agent 在对话中直接调。
  </Card>
</CardGroup>

想精确控制产物结构,见 [Artifact format 规范](/ai/artifact-format)。

## 手动安装(不用 CLI)

skill 就是一个带 frontmatter 的 `SKILL.md`。也可以从 CLI 包里取出,或直接放进项目的
`.claude/skills/plain/SKILL.md`。放好后 Claude Code 会在相关任务时自动加载它。