---
id: cinience/alicloud-skills/aliyun-solution-article-illustrator
version: "7ea1dae8"
license: MIT
install: manual
updated: 2026-07-18
---

# aliyun-solution-article-illustrator — This skill automates article illustration by analyzing markdown content, planning visuals across two dimensions—information structure (type) and aesthetics (style)—then generating and embedding images with local references. It integrates Alibaba Cloud image generation backends and preserves workflow state through validation gates.

Publisher: cinience · Stars: 397 · Updated: 2026-07-18

Install (manual): `git clone https://github.com/cinience/alicloud-skills`

## SKILL.md

Category: solution

# Content Article Illustrator

Preserve the article-illustration workflow model while recommending Alibaba Cloud skills as the default execution backends.

## Two Dimensions

| Dimension | Controls | Examples |
|-----------|----------|----------|
| **Type** | Information structure | infographic, scene, flowchart, comparison, framework, timeline |
| **Style** | Visual aesthetics | notion, warm, minimal, blueprint, watercolor, editorial |

## Validation

```bash
mkdir -p output/aliyun-solution-article-illustrator
python3 tests/common/compile_skill_scripts.py \
  --skill-path skills/solutions/aliyun-solution-article-illustrator \
  --output output/aliyun-solution-article-illustrator/compile-check.json
```

Pass criteria: command exits 0 and `output/aliyun-solution-article-illustrator/compile-check.json` is generated with `"status": "pass"`.

## Output And Evidence

- Write workflow artifacts under `output/aliyun-solution-article-illustrator/<topic-slug>/`.
- Save at least: `source.md`, `outline.md`, one prompt file, generated images, `article.with-images.md`, and `delivery-report.md`.
- Keep evidence for prompt-before-generation ordering and any edit pass used during repair.

## Prerequisites

- A source Markdown article.
- A generation backend that satisfies `references/backend-contract.md`.
- If you want repository-default behavior, prefer `aliyun-qwen-image` and `aliyun-qwen-image-edit`.
- Optional `EXTEND.md` preferences at project or user scope.

## Workflow

1. Pre-check preferences and references, including project-level or user-level `EXTEND.md`.
2. Analyze the source Markdown article and identify candidate illustration positions.
3. Confirm settings in one batch: Type, Density, Style, optional Language, and output size.
4. Choose or recommend a backend and build `outline.md`.
5. Save prompt files before any generation step.
6. Use the selected generation backend for first-pass images. Recommend `aliyun-qwen-image` by default.
7. If needed, use the selected edit backend for one repair pass per image. Recommend `aliyun-qwen-image-edit` by default.
8. Write `article.with-images.md` with relative `images/...` Markdown links.
9. Save evidence and produce `delivery-report.md`.

## Minimal Executable Run

```bash
python3 skills/solutions/aliyun-solution-article-illustrator/scripts/run_workflow.py \
  --source path/to/article.md \
  --output-dir output/aliyun-solution-article-illustrator/example-run \
  --generation-backend mock
```

## State Gates

- `drafted`: source article and initial outline exist
- `confirmed`: user settings, preferences, and backend choice are confirmed
- `generated`: prompt files and first-pass images exist
- `validated`: artifact structure and Markdown insertion pass checks
- `delivered`: final article and report are written

## References

- Detailed workflow: `references/workflow.md`
- Usage examples: `references/usage.md`
- Style system: `references/styles.md`
- Backend contract: `references/backend-contract.md`
- Prompt construction rules: `references/prompt-construction.md`
- Output contract: `references/output-spec.md`
- Validation and test expectations: `references/test-plan.md`
- Config setup: `references/config/first-time-setup.md`
- Preferences schema: `references/config/preferences-schema.md`
- Source references: `references/sources.md`
- Helper scripts: `scripts/load_preferences.py`, `scripts/validate_inputs.py`, `scripts/build_outline.py`, `scripts/collect_evidence.py`


[View on SkillFed](https://skillfed.io/cinience/alicloud-skills/aliyun-solution-article-illustrator) · [View on GitHub](https://github.com/cinience/alicloud-skills)