# MiaoGai Skills

Agent skills for [MiaoGai](https://www.miaogai.com) (秒改Ai) — inspect designs, export assets, analyze tokens, and modify `.fig` files from coding agents.

This repository is a MiaoGai fork of [open-pencil/skills](https://github.com/open-pencil/skills). The `skills.sh` layout is unchanged: each skill lives at `skills/<name>/SKILL.md`.

## Install

Private Gitea (SSH):

```bash
npx skills add ssh://git@git.zhangjianliang.com:2222/miaogai/skills.git --skill miaogai
```

The installer copies `skills/miaogai/SKILL.md` into the agent skill directory (for example `.cursor/skills/miaogai/` or `~/.cursor/skills/miaogai/`). It does **not** install the CLI or MCP server.

Then install the tools the skill tells the agent to run:

```bash
bun add -g @open-pencil/cli @open-pencil/mcp
```

Binaries after install: `miaogai`, `miaogai-mcp`, `miaogai-mcp-http`.

## Available Skills

| Skill | Description |
|-------|-------------|
| `miaogai` | CLI + MCP tools for `.fig` files and the running MiaoGai editor |

## Syncing from upstream

```bash
git remote add upstream https://github.com/open-pencil/skills.git   # once
git fetch upstream
git merge upstream/master   # resolve SKILL.md for miaogai binaries and product names
```

Keep `skills/miaogai/` as the published skill folder. Do not restore `skills/open-pencil/` unless you also want the upstream skill name.

## Links

- [MiaoGai](https://www.miaogai.com) — product site
- [Documentation](https://www.miaogai.com/programmable/mcp-server)
- [MCP](https://www.npmjs.com/package/@open-pencil/mcp) — `miaogai-mcp` / `miaogai-mcp-http`
- [CLI](https://www.npmjs.com/package/@open-pencil/cli) — `miaogai`