Skip to content

Commit d520b2b

Browse files
authored
stacks: add youfang stack with magic-move-deck (#14)
* stacks: add atlas stack with magic-move-deck New team stack stacks/atlas with one skill, magic-move-deck: turns an architecture or flow walkthrough into a Keynote-style Magic Move slide deck (one offline 1920x1080 HTML; shared boxes and titles morph between slides). Four style templates (hand-drawn, minimal, dark neon, neo-brutalist) share one helper API, so the agent renders one sample slide per style, the user picks one, and the rest of the deck is drawn in that style. Includes a neutral 19-slide example (RAG knowledge assistant) with previews, NOTICE.md crediting the MIT handdrawn-diagram template, marketplace entries for Claude Code and Codex, and rows in the stack listings and READMEs. * stacks: rename atlas stack to youfang Rename the directory, plugin name, author, homepage and every listing (marketplaces, stacks/README.md, both top-level READMEs) from atlas to youfang.
1 parent 88f84be commit d520b2b

56 files changed

Lines changed: 5903 additions & 9 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.agents/plugins/marketplace.json‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,18 @@
3939
"authentication": "ON_INSTALL"
4040
},
4141
"category": "Productivity"
42+
},
43+
{
44+
"name": "youfang",
45+
"source": {
46+
"source": "local",
47+
"path": "./stacks/youfang"
48+
},
49+
"policy": {
50+
"installation": "AVAILABLE",
51+
"authentication": "ON_INSTALL"
52+
},
53+
"category": "Productivity"
4254
}
4355
]
4456
}

‎.claude-plugin/marketplace.json‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,16 @@
3636
"name": "MiniMax Code team"
3737
},
3838
"homepage": "https://github.com/MiniMax-AI/mcode-stack/tree/main/stacks/req-tpm"
39+
},
40+
{
41+
"name": "youfang",
42+
"source": "./stacks/youfang",
43+
"description": "Turn architecture and flow diagrams into Keynote-style Magic Move slide decks: one offline HTML file where the boxes and titles two slides share morph and fly, in one of four visual styles (hand-drawn, minimal, dark neon, neo-brutalist) picked from rendered samples, with optional 4K video export.",
44+
"category": "Productivity",
45+
"author": {
46+
"name": "Youfang (MiniMax Code team)"
47+
},
48+
"homepage": "https://github.com/MiniMax-AI/mcode-stack/tree/main/stacks/youfang"
3949
}
4050
]
4151
}

‎README.md‎

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -43,9 +43,9 @@ Inside a Claude Code session:
4343
/plugin install ronny --marketplace MiniMax-AI/mcode-stack
4444
```
4545

46-
Use `jiachen` or `req-tpm` in place of `ronny` for those stacks. From a clone of this
47-
repository, `scripts/install.sh` installs `ronny` (`scripts/install.sh jiachen`
48-
or `scripts/install.sh req-tpm` for the others) with `claude` or `codex` when either is on `PATH`, and
46+
Use `jiachen`, `req-tpm` or `youfang` in place of `ronny` for those stacks. From a clone of this
47+
repository, `scripts/install.sh` installs `ronny` (`scripts/install.sh jiachen`,
48+
`scripts/install.sh req-tpm` or `scripts/install.sh youfang` for the others) with `claude` or `codex` when either is on `PATH`, and
4949
otherwise copies that stack's skills into `~/.agents/skills/`.
5050

5151
Older Claude Code can add the marketplace first, then install:
@@ -63,7 +63,7 @@ codex plugin marketplace add MiniMax-AI/mcode-stack
6363
codex plugin add ronny@mcode-stack
6464
```
6565

66-
Substitute `jiachen` or `req-tpm` the same way. To take a single skill instead of the
66+
Substitute `jiachen`, `req-tpm` or `youfang` the same way. To take a single skill instead of the
6767
plugin, copy that skill's folder into `~/.agents/skills/`. Codex and MiniMax
6868
Code both scan that directory; the copy steps are below.
6969

@@ -163,6 +163,14 @@ v0 and needs the `meegle` and `lark-cli` CLIs plus a one-time look-up of your
163163
Meegle space's fields and states; see
164164
[`stacks/req-tpm/README.md`](stacks/req-tpm/README.md).
165165

166+
[`stacks/youfang`](stacks/youfang/) has
167+
[`magic-move-deck`](stacks/youfang/skills/magic-move-deck/SKILL.md), which
168+
turns an architecture or flow walkthrough into a Keynote-style Magic Move
169+
slide deck: every slide is a diagram seen through a camera, and the boxes and
170+
titles two slides share morph between them. The agent shows one sample slide
171+
in each of four styles (hand-drawn, minimal, dark neon, neo-brutalist) and
172+
builds the deck in the one you pick, as a single offline HTML file.
173+
166174
A stack usually has three kinds of things:
167175

168176
| Kind | What it is | How to use it |
@@ -205,15 +213,17 @@ change it. To suggest a change here, open an issue; see
205213
stacks/ronny/ Ronny's stack (MiniMax Code R&D lead), the first and most complete one
206214
stacks/jiachen/ Jiachen's stack: getting out of the agent loop, and turning notes into posts and videos
207215
stacks/req-tpm/ Optional: the requester and their agent act as a requirement's TPM (Feishu doc body, Meegle status); v0
216+
stacks/youfang/ Youfang's stack: architecture walkthroughs as Magic Move slide decks, in four styles
208217
stacks/<name>/ One directory per team member; teammates are welcome to add theirs
209218
notes/ Which runnable piece goes with each Engineering Notes article
210219
community/ Stacks from outside the team, added by collaborators
211220
templates/stack-template/ Template for a new stack
212221
```
213222

214223
Every stack is also a MiniMax Code plugin package. See
215-
[`stacks/ronny`](stacks/ronny/), [`stacks/jiachen`](stacks/jiachen/) and
216-
[`stacks/req-tpm`](stacks/req-tpm/) for what each one contains.
224+
[`stacks/ronny`](stacks/ronny/), [`stacks/jiachen`](stacks/jiachen/),
225+
[`stacks/req-tpm`](stacks/req-tpm/) and [`stacks/youfang`](stacks/youfang/) for
226+
what each one contains.
217227

218228
## Contributing
219229

‎README_ZH.md‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ claude plugin install ronny --marketplace MiniMax-AI/mcode-stack
3636
/plugin install ronny --marketplace MiniMax-AI/mcode-stack
3737
```
3838

39-
装 Jiachen 的 stack 时,把 `ronny` 换成 `jiachen`;装需求管理的 stack 时换成 `req-tpm`。克隆本仓库后可以跑 `scripts/install.sh`(默认 `ronny`,或 `scripts/install.sh jiachen`、`scripts/install.sh req-tpm`):`PATH` 里有 `claude` 或 `codex` 时,它会执行同样的安装,否则把该 stack 的 Skill 复制到 `~/.agents/skills/`。
39+
装 Jiachen 的 stack 时,把 `ronny` 换成 `jiachen`;装需求管理的 stack 时换成 `req-tpm`;装 Youfang 的 stack 时换成 `youfang`。克隆本仓库后可以跑 `scripts/install.sh`(默认 `ronny`,或 `scripts/install.sh jiachen`、`scripts/install.sh req-tpm`、`scripts/install.sh youfang`):`PATH` 里有 `claude` 或 `codex` 时,它会执行同样的安装,否则把该 stack 的 Skill 复制到 `~/.agents/skills/`。
4040

4141
较旧的 Claude Code 可以先加市场,再安装:
4242

@@ -52,7 +52,7 @@ codex plugin marketplace add MiniMax-AI/mcode-stack
5252
codex plugin add ronny@mcode-stack
5353
```
5454

55-
把 `ronny` 换成 `jiachen` 即可。如果只要某一个 Skill,把它的目录复制到 `~/.agents/skills/`。Codex 和 MiniMax Code 都会扫描这个目录,复制步骤见下文。
55+
把 `ronny` 换成 `jiachen`、`req-tpm` 或 `youfang` 即可。如果只要某一个 Skill,把它的目录复制到 `~/.agents/skills/`。Codex 和 MiniMax Code 都会扫描这个目录,复制步骤见下文。
5656

5757
**装一个 Skill,所有项目都能用:**
5858

@@ -122,6 +122,8 @@ MiniMax Code 会自动发现这几个目录里的 Skill(每个 Skill 一个子
122122

123123
[`stacks/req-tpm`](stacks/req-tpm/README_ZH.md) 是一份可选的需求管理 stack:谁提的产品或技术需求,谁就和自己的 agent 一起当这条需求的 TPM。受理时先追问该不该做,写死可衡量的预期效果;优先级交给负责人拍板;记下方案决策;按节奏跟进,停滞的显式标出来;上线前过检查项;最后拿证据对照预期效果才关闭。需求正文放飞书文档,状态和流转放飞书项目(Meegle)。目前是 v0,需要 `meegle` 和 `lark-cli`,并先在自己的 Meegle 空间里查一遍字段和状态,见 [`stacks/req-tpm/README_ZH.md`](stacks/req-tpm/README_ZH.md)。
124124

125+
[`stacks/youfang`](stacks/youfang/) 里有 [`magic-move-deck`](stacks/youfang/skills/magic-move-deck/SKILL.md):把一次架构或流程讲解做成 Keynote 式「神奇移动」演示,每一页都是某张图加一个镜头取景,前后页共有的框和标题直接变形飞过去。agent 先用四种风格(手绘、简约、暗色科技、新野兽派)各出一张样张,你选定后再按这种风格做完整的单文件离线 HTML。
126+
125127
每个 stack 里一般有三类东西:
126128

127129
| 类型 | 是什么 | 怎么用 |
@@ -156,13 +158,14 @@ AI 写代码越来越快,真正拉开差距的,是围绕 agent 的那一圈
156158
stacks/ronny/ MiniMax Code 研发负责人 Ronny 的日常工作流,第一份,也是目前最完整的一份
157159
stacks/jiachen/ Jiachen 的工作流:把自己从 agent 的循环里解放出来,以及把笔记做成图文和短视频
158160
stacks/req-tpm/ 可选:需求提出人和自己的 agent 一起当这条需求的 TPM(正文在飞书文档,状态在 Meegle),v0
161+
stacks/youfang/ Youfang 的工作流:把架构讲解做成「神奇移动」演示,四种风格可选
159162
stacks/<name>/ 每位成员一个目录,欢迎团队同事把自己的也放进来
160163
notes/ 「MCode 工程笔记」每一篇对应哪一份能跑的东西
161164
community/ 团队外的 stack,由协作者加进来
162165
templates/stack-template/ 新增 stack 用的模板
163166
```
164167

165-
每份 stack 本身也是一个 MiniMax Code 插件包,具体内容见 [`stacks/ronny`](stacks/ronny/)、[`stacks/jiachen`](stacks/jiachen/) 和 [`stacks/req-tpm`](stacks/req-tpm/README_ZH.md)。
168+
每份 stack 本身也是一个 MiniMax Code 插件包,具体内容见 [`stacks/ronny`](stacks/ronny/)、[`stacks/jiachen`](stacks/jiachen/)、[`stacks/req-tpm`](stacks/req-tpm/README_ZH.md) 和 [`stacks/youfang`](stacks/youfang/)。
166169

167170
## 参与贡献
168171

‎stacks/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ MiniMax Code plugin package.
99
| [`ronny`](ronny/) | Ronny, R&D lead | Skills and plain-text checklists |
1010
| [`jiachen`](jiachen/) | Jiachen, engineer | Skills and a `WORKFLOW.md` |
1111
| [`req-tpm`](req-tpm/) | MiniMax Code team | Optional, v0: the requester and their agent act as a requirement's TPM (Feishu doc body, Meegle status). Skills, templates and a `WORKFLOW.md` |
12+
| [`youfang`](youfang/) | Youfang, engineer | A skill that turns diagram walkthroughs into Magic Move slide decks (four styles, sample first), and a `WORKFLOW.md` |
1213

1314
Teammates are welcome to add their own; see below.
1415

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"name": "youfang",
3+
"displayName": "Youfang's MCode Stack",
4+
"version": "0.1.0",
5+
"description": "Turn architecture and flow diagrams into Keynote-style Magic Move slide decks: one offline HTML file where the boxes and titles two slides share morph and fly, in one of four visual styles (hand-drawn, minimal, dark neon, neo-brutalist) picked from rendered samples, with optional 4K video export.",
6+
"author": {
7+
"name": "Youfang (MiniMax Code team)"
8+
},
9+
"homepage": "https://github.com/MiniMax-AI/mcode-stack/tree/main/stacks/youfang",
10+
"repository": "https://github.com/MiniMax-AI/mcode-stack"
11+
}
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
{
2+
"name": "youfang",
3+
"version": "0.1.0",
4+
"description": "Turn architecture and flow diagrams into Keynote-style Magic Move slide decks: one offline HTML file where the boxes and titles two slides share morph and fly, in one of four visual styles (hand-drawn, minimal, dark neon, neo-brutalist) picked from rendered samples, with optional 4K video export.",
5+
"author": {
6+
"name": "Youfang (MiniMax Code team)"
7+
},
8+
"homepage": "https://github.com/MiniMax-AI/mcode-stack/tree/main/stacks/youfang",
9+
"repository": "https://github.com/MiniMax-AI/mcode-stack",
10+
"skills": "./skills/",
11+
"interface": {
12+
"displayName": "Youfang's MCode Stack",
13+
"shortDescription": "Diagram walkthroughs as Magic Move slide decks, in four styles.",
14+
"longDescription": "Turn architecture and flow diagrams into Keynote-style Magic Move slide decks: one offline HTML file where the boxes and titles two slides share morph and fly, in one of four visual styles (hand-drawn, minimal, dark neon, neo-brutalist) picked from rendered samples, with optional 4K video export.",
15+
"developerName": "Youfang (MiniMax Code team)",
16+
"category": "Productivity",
17+
"capabilities": [
18+
"Read",
19+
"Write"
20+
],
21+
"websiteURL": "https://github.com/MiniMax-AI/mcode-stack/tree/main/stacks/youfang",
22+
"defaultPrompt": [
23+
"把这套架构讲解做成 Magic Move 演示,先给我看四种风格的样张",
24+
"Make an animated slide deck that walks through our ingestion pipeline",
25+
"Switch this deck to the dark neon style and export a 1080p video"
26+
]
27+
}
28+
}
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
{
2+
"schemaVersion": 1,
3+
"name": "youfang",
4+
"version": "0.1.0",
5+
"displayName": "Youfang's MCode Stack",
6+
"description": "Turn architecture and flow diagrams into Keynote-style Magic Move slide decks: one offline HTML file where the boxes and titles two slides share morph and fly, in one of four visual styles (hand-drawn, minimal, dark neon, neo-brutalist) picked from rendered samples, with optional 4K video export.",
7+
"author": "Youfang (MiniMax Code team)",
8+
"icon": "icon.png",
9+
"category": "Productivity",
10+
"exampleQueries": [
11+
"把这套架构讲解做成 Magic Move 演示,先给我看四种风格的样张",
12+
"Make an animated slide deck that walks through our ingestion pipeline",
13+
"Switch this deck to the dark neon style and export a 1080p video"
14+
],
15+
"apps": [],
16+
"mcpServers": [],
17+
"skills": [
18+
"skills/magic-move-deck/SKILL.md"
19+
]
20+
}

‎stacks/youfang/NOTICE.md‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# Third-party notices
2+
3+
## handdrawn-diagram
4+
5+
[`skills/magic-move-deck/styles/handdrawn/diagram.html`](skills/magic-move-deck/styles/handdrawn/diagram.html)
6+
is adapted from the template in
7+
[TrentChou/handdrawn-diagram](https://github.com/TrentChou/handdrawn-diagram):
8+
its palette, typography, shape helpers and `main()` contract. The other three
9+
style templates follow the same helper API. Changes for this stack: a 1920×1080
10+
default canvas, a card palette (`C.card`) and a `glow` entry used by the deck
11+
engine.
12+
13+
```
14+
MIT License
15+
16+
Copyright (c) 2026 TrentChou
17+
18+
Permission is hereby granted, free of charge, to any person obtaining a copy
19+
of this software and associated documentation files (the "Software"), to deal
20+
in the Software without restriction, including without limitation the rights
21+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
22+
copies of the Software, and to permit persons to whom the Software is
23+
furnished to do so, subject to the following conditions:
24+
25+
The above copyright notice and this permission notice shall be included in all
26+
copies or substantial portions of the Software.
27+
28+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
29+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
30+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
31+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
32+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
33+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
34+
SOFTWARE.
35+
```
36+
37+
## Loaded at run time, not bundled
38+
39+
- [rough.js](https://roughjs.com) 4.6.6 (MIT), loaded from jsDelivr when a
40+
diagram is rendered. Built decks contain the SVG it produced, not the
41+
library.
42+
- [Noto Serif SC](https://fonts.google.com/noto/specimen/Noto+Serif+SC)
43+
(SIL Open Font License 1.1), loaded from Google Fonts by the hand-drawn
44+
template as a fallback when no Songti font is installed.
45+
- [Playwright](https://playwright.dev) (Apache-2.0) and ffmpeg run the build,
46+
screenshot and video scripts; they are installed by the user.
47+
48+
Everything else in this stack is released under the repository's
49+
[MIT License](../../LICENSE).

‎stacks/youfang/README.md‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
# youfang
2+
3+
The stack of Youfang, an engineer on MiniMax Code: one skill that turns an
4+
architecture or flow walkthrough into a Keynote-style **Magic Move** slide
5+
deck. Every slide is a diagram seen through a camera, and the boxes, labels
6+
and titles two slides share morph and fly instead of cross-fading. The agent
7+
first renders one sample slide in each of four styles; you pick one and it
8+
builds the whole deck in that style.
9+
10+
| A · Hand-drawn | B · Minimal |
11+
| --- | --- |
12+
| ![hand-drawn](skills/magic-move-deck/styles/handdrawn/preview.png) | ![minimal](skills/magic-move-deck/styles/minimal/preview.png) |
13+
| **C · Dark neon** | **D · Neo-brutalist** |
14+
| ![neon](skills/magic-move-deck/styles/neon/preview.png) | ![brutalist](skills/magic-move-deck/styles/brutalist/preview.png) |
15+
16+
## Install
17+
18+
In Claude Code, one command installs this stack. In a shell:
19+
20+
```bash
21+
claude plugin install youfang --marketplace MiniMax-AI/mcode-stack
22+
```
23+
24+
Inside a session:
25+
26+
```bash
27+
/plugin install youfang --marketplace MiniMax-AI/mcode-stack
28+
```
29+
30+
Older Claude Code can add the marketplace first, then install:
31+
32+
```bash
33+
/plugin marketplace add MiniMax-AI/mcode-stack
34+
/plugin install youfang@mcode-stack
35+
```
36+
37+
In Codex, add the marketplace, then install from the Plugins Directory or the CLI:
38+
39+
```bash
40+
codex plugin marketplace add MiniMax-AI/mcode-stack
41+
codex plugin add youfang@mcode-stack
42+
```
43+
44+
In MiniMax Code, copy this whole directory into the local plugin directory
45+
shown by `mcode plugin marketplace list`, or copy the skill into
46+
`~/.agents/skills/`. See the [repository README](../../README.md#quick-start).
47+
48+
| Skill | What it does |
49+
| --- | --- |
50+
| [`magic-move-deck`](skills/magic-move-deck/SKILL.md) | Plan the storyline (cover → overview → per topic: zoom into its region, detail diagram, three spotlights → overview → closing card), draw one detail diagram, render it in four styles for you to choose, then draw the remaining diagrams in that style and build one offline 1920×1080 HTML deck. Shared elements are matched by name across slides. Screenshots every slide and transition to check the result; optional 4K / 1080p video with background music. |
51+
52+
A complete example deck (a RAG knowledge assistant, 19 slides) with its
53+
sources, configuration and previews is in
54+
[`skills/magic-move-deck/examples/rag-assistant/`](skills/magic-move-deck/examples/rag-assistant/).
55+
56+
## Requirements
57+
58+
- Python 3 and Playwright's Chromium:
59+
`pip install playwright && playwright install chromium`.
60+
- `ffmpeg`, only for video export.
61+
- Network access while diagrams are rendered (rough.js from jsDelivr). The
62+
built deck is a single file that works offline.
63+
- Fonts: Times New Roman and a Songti font for the hand-drawn style (shipped
64+
with macOS and Windows); the other styles use the system UI font with
65+
PingFang SC, Microsoft YaHei or Noto Sans SC for Chinese.
66+
67+
How this fits into a working day: [`WORKFLOW.md`](WORKFLOW.md). Third-party
68+
credits: [`NOTICE.md`](NOTICE.md).

0 commit comments

Comments
 (0)