paper-comic

Name: paper-comic
Author: proyecto26

27installs2forks

How to install paper-comic?

proyecto26/sherlock-ai-plugin/paper-comic

$npx -y skills add proyecto26/sherlock-ai-plugin --skill paper-comic

Installs into the current project.

Summary

Generate educational comics from academic papers, using visual storytelling to explain core ideas and innovations. Supports 4 art styles: classic (clean lines), tech (futuristic), warm (friendly), chalk (blackboard). Uses genimg-gemini-web to generate images.

Files · 1

View on GitHub

SKILL.md

1	# Paper Comic - Academic Paper to Comic Generator
2
3	Transform academic papers into coherent educational comics, making complex concepts easier to understand through visual storytelling.
4
5	## Usage
6
7	```bash
8	/paper-comic /path/to/paper.pdf
9	/paper-comic /path/to/paper.pdf --style tech
10	/paper-comic # Then paste the paper content
11	```
12
13	## Art Style Options
14
15	\| Style \| Features \| Suitable Papers \|
16	\|-------\|-----------\|-----------------\|
17	\| classic \| Clean-line style, simple and professional, easy to read \| General purpose, most papers (default) \|
18	\| tech \| Futuristic look, circuit and neon elements \| AI/Computer/Engineering papers \|
19	\| warm \| Gentle tone, nostalgic feeling, approachable \| Psychology/Cognitive Science/Education \|
20	\| chalk \| Blackboard effect, academic atmosphere \| Math/Physics/Theoretical papers \|
21
22	## Output Structure
23
24	```
25	[output-dir]/
26	├── outline.md # Storyboard and scene outline
27	├── characters/
28	│ ├── characters.md # Character definitions
29	│ └── characters.png # Character reference image
30	├── prompts/
31	│ ├── 00-cover.md # Cover prompt
32	│ └── XX-page.md # Page prompts
33	├── 00-cover.png # Cover page
34	└── XX-page.png # Comic pages
35	```
36
37	Output Directory:
38	- If source files exist: `[source-dir]/comic/`
39	- If no source files: `comic-outputs/YYYY-MM-DD/[topic-slug]/`
40
41	## Workflow
42
43	### Step 1: Analyze the Paper
44
45	1. Read paper content (PDF or Markdown)
46	2. Extract key information:
47	- Paper title and authors
48	- Research background and motivation
49	- Core innovations (1–3)
50	- Key methods/algorithms
51	- Main experimental results
52	3. Automatically recommend an art style based on the paper field (or use user-specified style)
53
54	### Step 2: Design Narrative Structure
55
56	Four-part structure (suitable for 8–12 pages of comic):
57
58	\| Stage \| Pages \| Content \|
59	\|--------\|--------\|---------\|
60	\| Introduction \| 1–2 pages \| Problem background — why the research is needed \|
61	\| Exploration \| 2–3 pages \| Limitations of existing methods, leading to innovation \|
62	\| Core \| 3–5 pages \| Explain the innovation in detail, visualized with metaphors \|
63	\| Summary \| 1–2 pages \| Experimental results, significance, and future outlook \|
64
65	### Step 3: Define Characters
66
67	Create `characters/characters.md`:
68
69	Required characters:
70	- Mentor: The explainer, wise and approachable
71	- Student: Represents the reader, asks questions and learns
72	- Concept embodiment (optional): A personified version of an abstract concept
73
74	Character consistency rules:
75	- Mentor and student must appear in ≥60% of pages
76	- Each page should clearly list appearing characters
77	- Character design must remain consistent throughout all pages
78
79	### Step 4: Create Storyboard
80
81	Create `outline.md`, containing:
82	- Metadata (title, art style, page count)
83	- Cover design
84	- Panel layout and content of each page
85
86	Storyboard rules:
87	- Each page has 3–5 panels
88	- Note which characters, scenes, and dialogue appear in each panel
89	- All dialogue must be written in Chinese
90	- Formulas should be represented visually, not as text formulas
91
92	### Step 5: Generate Images
93
94	Use genimg-gemini-web to generate images (requires Google account authentication):
95
96	```bash
97	# Get skill installation path (assuming installed via npx skills add)
98	SKILL_DIR="$HOME/.claude/skills/genimg-gemini-web"
99	# Or if located elsewhere:
100	# SKILL_DIR="$HOME/.codex/skills/genimg-gemini-web"
101
102	# Generate character reference image
103	npx -y bun "$SKILL_DIR/scripts/main.ts" \
104	--promptfiles references/base-prompt.md characters/characters.md \
105	--image characters/characters.png \
106	--sessionId comic-[topic]-[timestamp]
107
108	# Generate pages (use the same sessionId for consistency)
109	npx -y bun "$SKILL_DIR/scripts/main.ts" \
110	--promptfiles references/base-prompt.md prompts/XX-page.md \
111	--image XX-page.png \
112	--sessionId comic-[topic]-[timestamp]
113	```
114
115	Important: Use the same `--sessionId` across all runs to ensure consistent character appearance.
116
117	First run: Chrome will open for Google account authentication; cookies will then be cached.
118
119	### Step 6: Generate Final Document
120
121	Generate `[topic]-paper-comic.md`:
122
123	```markdown
124	# [Paper Title] - Comic Interpretation
125
126	## Overview
127	- Paper: [Title]
128	- Art Style: [Selected Style]
129	- Pages: [N]
130	- Generated on: [YYYY-MM-DD]
131
132	## Comic Pages
133
134	### Cover
135
136
137	### Page 1
138
139	Content: [Brief summary of this page’s content]
140
141	...
142
143	## Core Knowledge Points
144	1. [Concept 1]
145	2. [Concept 2]
146	3. [Concept 3]
147	```
148
149	## Key Principles
150
151	### Text Requirements
152	- All dialogue and narration must be in Chinese
153	- Professional terms: Chinese + English, e.g., “梯度下降 (Gradient Descent)”
154	- Text must be clear and readable
155
156	##

People who liked this also viewed

6 picks

Type

paper-comic

27installs2forks

View on GitHub

How to install paper-comic?

proyecto26/sherlock-ai-plugin/paper-comic

$npx -y skills add proyecto26/sherlock-ai-plugin --skill paper-comic

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Paper Comic - Academic Paper to Comic Generator
2
3	Transform academic papers into coherent educational comics, making complex concepts easier to understand through visual storytelling.
4
5	## Usage
6
7	```bash
8	/paper-comic /path/to/paper.pdf
9	/paper-comic /path/to/paper.pdf --style tech
10	/paper-comic # Then paste the paper content
11	```
12
13	## Art Style Options
14
15	\| Style \| Features \| Suitable Papers \|
16	\|-------\|-----------\|-----------------\|
17	\| classic \| Clean-line style, simple and professional, easy to read \| General purpose, most papers (default) \|
18	\| tech \| Futuristic look, circuit and neon elements \| AI/Computer/Engineering papers \|
19	\| warm \| Gentle tone, nostalgic feeling, approachable \| Psychology/Cognitive Science/Education \|
20	\| chalk \| Blackboard effect, academic atmosphere \| Math/Physics/Theoretical papers \|
21
22	## Output Structure
23
24	```
25	[output-dir]/
26	├── outline.md # Storyboard and scene outline
27	├── characters/
28	│ ├── characters.md # Character definitions
29	│ └── characters.png # Character reference image
30	├── prompts/
31	│ ├── 00-cover.md # Cover prompt
32	│ └── XX-page.md # Page prompts
33	├── 00-cover.png # Cover page
34	└── XX-page.png # Comic pages
35	```
36
37	Output Directory:
38	- If source files exist: `[source-dir]/comic/`
39	- If no source files: `comic-outputs/YYYY-MM-DD/[topic-slug]/`
40
41	## Workflow
42
43	### Step 1: Analyze the Paper
44
45	1. Read paper content (PDF or Markdown)
46	2. Extract key information:
47	- Paper title and authors
48	- Research background and motivation
49	- Core innovations (1–3)
50	- Key methods/algorithms
51	- Main experimental results
52	3. Automatically recommend an art style based on the paper field (or use user-specified style)
53
54	### Step 2: Design Narrative Structure
55
56	Four-part structure (suitable for 8–12 pages of comic):
57
58	\| Stage \| Pages \| Content \|
59	\|--------\|--------\|---------\|
60	\| Introduction \| 1–2 pages \| Problem background — why the research is needed \|
61	\| Exploration \| 2–3 pages \| Limitations of existing methods, leading to innovation \|
62	\| Core \| 3–5 pages \| Explain the innovation in detail, visualized with metaphors \|
63	\| Summary \| 1–2 pages \| Experimental results, significance, and future outlook \|
64
65	### Step 3: Define Characters
66
67	Create `characters/characters.md`:
68
69	Required characters:
70	- Mentor: The explainer, wise and approachable
71	- Student: Represents the reader, asks questions and learns
72	- Concept embodiment (optional): A personified version of an abstract concept
73
74	Character consistency rules:
75	- Mentor and student must appear in ≥60% of pages
76	- Each page should clearly list appearing characters
77	- Character design must remain consistent throughout all pages
78
79	### Step 4: Create Storyboard
80
81	Create `outline.md`, containing:
82	- Metadata (title, art style, page count)
83	- Cover design
84	- Panel layout and content of each page
85
86	Storyboard rules:
87	- Each page has 3–5 panels
88	- Note which characters, scenes, and dialogue appear in each panel
89	- All dialogue must be written in Chinese
90	- Formulas should be represented visually, not as text formulas
91
92	### Step 5: Generate Images
93
94	Use genimg-gemini-web to generate images (requires Google account authentication):
95
96	```bash
97	# Get skill installation path (assuming installed via npx skills add)
98	SKILL_DIR="$HOME/.claude/skills/genimg-gemini-web"
99	# Or if located elsewhere:
100	# SKILL_DIR="$HOME/.codex/skills/genimg-gemini-web"
101
102	# Generate character reference image
103	npx -y bun "$SKILL_DIR/scripts/main.ts" \
104	--promptfiles references/base-prompt.md characters/characters.md \
105	--image characters/characters.png \
106	--sessionId comic-[topic]-[timestamp]
107
108	# Generate pages (use the same sessionId for consistency)
109	npx -y bun "$SKILL_DIR/scripts/main.ts" \
110	--promptfiles references/base-prompt.md prompts/XX-page.md \
111	--image XX-page.png \
112	--sessionId comic-[topic]-[timestamp]
113	```
114
115	Important: Use the same `--sessionId` across all runs to ensure consistent character appearance.
116
117	First run: Chrome will open for Google account authentication; cookies will then be cached.
118
119	### Step 6: Generate Final Document
120
121	Generate `[topic]-paper-comic.md`:
122
123	```markdown
124	# [Paper Title] - Comic Interpretation
125
126	## Overview
127	- Paper: [Title]
128	- Art Style: [Selected Style]
129	- Pages: [N]
130	- Generated on: [YYYY-MM-DD]
131
132	## Comic Pages
133
134	### Cover
135
136
137	### Page 1
138
139	Content: [Brief summary of this page’s content]
140
141	...
142
143	## Core Knowledge Points
144	1. [Concept 1]
145	2. [Concept 2]
146	3. [Concept 3]
147	```
148
149	## Key Principles
150
151	### Text Requirements
152	- All dialogue and narration must be in Chinese
153	- Professional terms: Chinese + English, e.g., “梯度下降 (Gradient Descent)”
154	- Text must be clear and readable
155
156	##

People who liked this also viewed

6 picks

Type