mcpField
A
alicloud-solution-content-article-illustrator

alicloud-solution-content-article-illustrator

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

About alicloud-solution-content-article-illustrator

A workflow skill for adding illustrations to Markdown articles, aimed at producing an illustrated article with documented outputs. It organizes choices by information type and visual style, and recommends Alibaba Cloud skills as default image-generation and editing backends.

Key features

  1. 01Analyze articles and locate illustration positions
  2. 02Set information type, density, and visual style
  3. 03Build an outline and save prompts before generation
  4. 04Generate and optionally repair images
  5. 05Insert images and produce a delivery report

Use cases

  1. 01Illustrate a source Markdown article
  2. 02Create a documented image-generation workflow

Install

Copy the command and run it in a terminal.

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

After installing, type/alicloud-solution-content-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/alicloud-solution-content-article-illustrator
python3 tests/common/compile_skill_scripts.py \
  --skill-path skills/solutions/alicloud-solution-content-article-illustrator \
  --output output/alicloud-solution-content-article-illustrator/compile-check.json

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

Output And Evidence

  • Write workflow artifacts under output/alicloud-solution-content-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 alicloud-ai-image-qwen-image and alicloud-ai-image-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 alicloud-ai-image-qwen-image by default.
  7. If needed, use the selected edit backend for one repair pass per image. Recommend alicloud-ai-image-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/alicloud-solution-content-article-illustrator/scripts/run_workflow.py \
  --source path/to/article.md \
  --output-dir output/alicloud-solution-content-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