mcpField
A
aliyun-solution-article-illustrator

aliyun-solution-article-illustrator

github.com/cinienceCreative & media396109 installsUpdated 11w ago
Repository

About aliyun-solution-article-illustrator

This skill turns Markdown articles into illustrated drafts for content creators who need a structured image workflow. It separates information type from visual style and recommends Alibaba Cloud skills as default image-generation and editing backends.

Key features

  1. 01Analyze articles and plan illustration positions
  2. 02Set type, density, and visual style
  3. 03Prepare prompts and first-pass images
  4. 04Repair images when needed
  5. 05Insert images and create a delivery report

Use cases

  1. 01Plan infographics or flowcharts for technical articles
  2. 02Illustrate Markdown articles in a chosen style
  3. 03Validate and deliver articles with inserted images

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-solution-article-illustrator

After installing, type/aliyun-solution-article-illustratorin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
prompts/
system.md
references/
backend-contract.md
output-spec.md
prompt-construction.md
sources.md
styles.md
test-plan.md
usage.md
workflow.md
references/config/
first-time-setup.md
preferences-schema.md
references/styles/
blueprint.md
editorial.md
minimal.md
notion.md
warm.md
watercolor.md
scripts/
build_outline.py
collect_evidence.py
load_preferences.py
run_workflow.py
validate_inputs.py
templates/
delivery-report.md
outline.md
prompt.md

Details

From the project README

Category: solution

Content Article Illustrator

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

Two Dimensions

DimensionControlsExamples
TypeInformation structureinfographic, scene, flowchart, comparison, framework, timeline
StyleVisual aestheticsnotion, warm, minimal, blueprint, watercolor, editorial

Validation

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

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

Comments

Markdown supported