aicomics - GitLite

KO | EN

gitlite — search

#linux #mcp #git #database #gemini #json #open-source #react #redis #pdf

aicomics

(★ 13)

A style-adaptive skill used to transform AI concepts into accurate, character-consistent Xiaohongshu explanation comics.

파일 탐색기

ZIP 다운로드

- - bug_report.yml
  - feature_request.yml
- pull_request_template.md
- openai.yaml
- hero-characters.png
- hero-qingchen-watermarked.png
- hero.svg
- showcase-prompt-engineer-cover-qingchen-v2.jpg
- accuracy-and-copy.md
- character-bible-template.md
- image-prompts.md
- new-character-protocol.md
- story-architecture.md
- style-intake.md
- new_comic_project.py
.gitignore
CONTRIBUTING.md
LICENSE
README.md
README.zh-CN.md
SKILL.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**English** | [简体中文](README.zh-CN.md)

<div align="center">
  <img src="docs/hero-qingchen-watermarked.png" alt="Make Xiaohongshu AI Comics — featuring Xiao Cheng and AI Xiao Lan with a subtle QINGCHEN watermark pattern" width="100%" />
</div>

<p align="center">
  <a href="https://github.com/chenjieliefu/make-xiaohongshu-ai-comics/blob/main/LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-8B5CF6?style=flat-square"></a>
  <img alt="Codex Skill" src="https://img.shields.io/badge/Codex-Skill-111827?style=flat-square">
  <img alt="Style adaptive" src="https://img.shields.io/badge/style-adaptive-06B6D4?style=flat-square">
  <img alt="Research first" src="https://img.shields.io/badge/content-research--first-F59E0B?style=flat-square">
</p>

<p align="center">
  <strong>Turn AI concepts into accurate, entertaining, character-consistent Xiaohongshu comics—in any visual style.</strong>
</p>

<p align="center">
  Research → style bible → character bible → storyboard → image prompts → QA → publish package.
</p>

---

## What is this?

<strong>Make Xiaohongshu AI Comics</strong> is an open-source Codex Skill for producing swipeable AI knowledge comics. It standardizes the reasoning-heavy parts of the workflow while leaving the visual direction open to every creator.

It does not prescribe a house style, fixed palette, or bundled cast. The documentation includes creator-owned showcase artwork, but those assets are not used by the workflow or copied into new projects. Each project derives its own visual language from the user's prompt or reference images, then freezes that language in a project-specific style bible.

## Why use it?

| Capability | What it protects |
|---|---|
| 🎨 Style-adaptive workflow | Different creators can use watercolor, collage, pixel art, editorial illustration, or their own references |
| 🧬 Character continuity | Recurring characters keep their silhouette, proportions, colors, accessories, and teaching roles |
| 🔎 Research-first writing | Definitions, boundaries, misconceptions, and limitations are checked before the comic copy is written |
| 📱 Xiaohongshu-native structure | One idea per 3:4 page, strong swipe rhythm, short mobile-readable copy |
| 🧪 Page-by-page QA | Exact Chinese text, technical terms, visual drift, and semantic qualifiers are reviewed |
| 📦 Repeatable delivery | Pages, caption, sources, bibles, prompts, drafts, and approved assets stay organized |

## How it works

~~~mermaid
flowchart LR
    A["Topic + audience"] --> B["Primary-source research"]
    B --> C["Project style bible"]
    C --> D["Original character bible"]
    D --> E["Swipeable storyboard"]
    E --> F["One image prompt per page"]
    F --> G["Text + visual QA"]
    G --> H["Publish package"]
~~~

The default story arc uses eight pages:

1. Cover and curiosity gap
2. Relatable friction
3. Accurate definition
4. Mechanism or real work
5. Concrete comparison
6. Evaluation and limits
7. Misconceptions
8. Actionable takeaway

## Made with this workflow

<table>
  <tr>
    <td width="34%" align="center">
      <img src="docs/showcase-prompt-engineer-cover-qingchen-v2.jpg" width="300" alt="Prompt Engineer AI explainer comic cover with a subtle full-canvas QINGCHEN watermark pattern" />
    </td>
    <td width="66%" valign="top">
      <h3>Prompt Engineer — an 8-page AI explainer comic</h3>
      <p>This finished cover demonstrates the workflow in a creator-selected visual direction:</p>
      <ul>
        <li>original recurring characters: Xiao Cheng and AI Xiao Lan</li>
        <li>mobile-readable Chinese copy and a clear curiosity gap</li>
        <li>character continuity across a complete swipeable story</li>
        <li>research-first definitions, boundaries, and misconceptions</li>
      </ul>
      <p><strong>Showcase only:</strong> this visual style and cast belong to the example project. The open-source Skill remains style-adaptive and does not use them as defaults.</p>
    </td>
  </tr>
</table>

## Quick start

### Install

Clone the repository into your Codex skills directory:

~~~bash
git clone https://github.com/chenjieliefu/make-xiaohongshu-ai-comics \
  "${CODEX_HOME:-$HOME/.codex}/skills/make-xiaohongshu-ai-comics"
~~~

You can also ask Codex to install the Skill from this GitHub repository when a Skill installer is available in your setup.

### Invoke

Mention the Skill explicitly:

~~~text
Use $make-xiaohongshu-ai-comics to turn “RAG” into an 8-page
Xiaohongshu explainer comic for non-technical readers.
Use my attached images only as high-level style references.
~~~

Or describe the visual direction in words:

~~~text
Use $make-xiaohongshu-ai-comics to explain AI Agents.
Make the series feel like a calm editorial collage with restrained colors,
paper cutout textures, original characters, and large readable Chinese text.
~~~

## Start a project folder

The bundled script creates a safe, non-destructive working structure:

~~~bash
python3 scripts/new_comic_project.py \
  --topic "What is RAG?" \
  --series "AI Field Notes" \
  --output "./episodes/rag"
~~~

It creates:

~~~text
episodes/rag/
├── brief.md
├── research.md
├── style-bible.md
├── character-bible.md
├── storyboard.md
├── generation-prompts.md
├── publish-caption.md
├── qa-checklist.md
├── pages/
├── drafts/
├── sources/
├── style-references/
└── character-references/
~~~

The script refuses to write into a non-empty directory.

## Style adaptation without copying

Reference images are treated as a source of high-level attributes:

- medium and edge behavior
- palette relationships
- texture and depth
- shape language
- information density and reading order
- typography behavior
- emotional tone

The workflow explicitly excludes copying reference characters, logos, signatures, watermarks, text, or exact compositions. New subjects, layouts, props, and recurring characters must remain original.

## Accuracy rules

The Skill is designed to keep the comic fun without turning AI concepts into magic:

- Prefer official documentation, standards, original research, and first-party technical sources.
- Preserve qualifiers such as “can,” “often,” and “for this task.”
- Separate prompting, context, tools, retrieval, model choice, fine-tuning, and evaluation.
- State what the method cannot solve by itself.
- Never invent statistics, benchmarks, salaries, quotes, or guaranteed outcomes.
- Treat corrupted in-image text as a draft, not a final.

## Repository structure

~~~text
.
├── SKILL.md                         # Core workflow and trigger description
├── agents/openai.yaml               # Codex UI metadata
├── docs/                             # README banner and showcase-only artwork
├── references/
│   ├── style-intake.md              # Build a style bible from text or images
│   ├── character-bible-template.md  # Freeze recurring character identity
│   ├── story-architecture.md        # Swipeable educational narrative
│   ├── accuracy-and-copy.md         # Knowledge and wording guardrails
│   ├── image-prompts.md             # Style-neutral prompt scaffolds
│   └── new-character-protocol.md    # Add cast members without visual drift
└── scripts/new_comic_project.py     # Safe project scaffolding
~~~

## Contributing

Ideas, fixes, translations, and workflow improvements are welcome. Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request.

Useful contribution areas:

- better multilingual copy QA
- new story architectures for different page counts
- stronger character-continuity checks
- accessibility and mobile-readability guidance
- examples that remain visually style-neutral

## License

Released under the [MIT License](LICENSE).

---

<p align="center">
  <strong>Make AI easier to understand—one swipe at a time.</strong>
</p>