SAP Article Generator

Generate optimized, fact-checked SAP technical articles as professional Word documents with embedded images, flowcharts, and references.

Overview

This skill is self-contained and includes:

• Web research and fact-checking capabilities

• Built-in image downloading from the web

• Professional Word document creation with docx

• Proper SAP formatting and terminology

• Embedded screenshots and diagrams

• Reference citations

Article Generation Workflow

Follow these steps in sequence for every article:

0. PREREQUISITE: Read docx Skill (MANDATORY)

REQUIRED before creating any Word document

cat /mnt/skills/public/docx/SKILL.md

1. Topic Analysis and Planning (2-3 minutes)

• Identify the SAP module, process, or topic

• Determine scope: configuration guide, conceptual overview, or troubleshooting

• Define target audience: beginner, intermediate, or advanced users

• Plan article structure based on topic type

2. Research and Fact-Checking (5-10 minutes)

CRITICAL: Always search before writing to ensure current, accurate information

Use web_search tool to verify:

• Latest SAP transaction codes and menu paths

• Current best practices and SAP Notes

• Version-specific differences (ECC vs S/4HANA)

• Official SAP documentation

Minimum 2-3 searches for any article.

Search query examples:

• "SAP [transaction code] [module] configuration"

• "SAP [process name] step by step guide"

• "SAP S/4HANA [topic] best practices"

3. Content Structure Planning

Configuration Guides:

• Introduction and business context

• Prerequisites and system requirements

• Configuration overview

• Step-by-step configuration with transaction codes

• IMG menu paths and settings

• Testing and validation

• Troubleshooting

• Best practices

• References

Conceptual Articles:

• Introduction and business context

• Key concepts and terminology

• Process flow and architecture

• Technical implementation

• Integration points

• Use cases and examples

• Best practices

• References

Troubleshooting Guides:

• Problem overview and symptoms

• Root cause analysis

• Diagnostic steps

• Solution steps

• Prevention strategies

• Related SAP Notes

• References

4. Visual Content Integration (CRITICAL - MUST DO THIS!)

Images significantly improve article quality. Every article MUST have 2-3+ embedded images.

Step 4.1: Search for Images

Use web_search to find relevant SAP images:

web_search("SAP [transaction] screenshot") web_search("SAP [process] flow diagram") web_search("SAP [module] configuration screen")

Image types to include:

• Transaction screen screenshots

• Process flow diagrams

• System architecture diagrams

• Configuration examples

• Data flow illustrations

Step 4.2: Extract Image URLs

From the web_search results, identify direct image URLs. Look for:

• .png, .jpg, .jpeg, .gif, .svg, .webp URLs

• Image URLs in search results snippets

• URLs from SAP blogs, tutorials, help portal

Step 4.3: Download Images Using Built-in Script

Install dependencies first (if not already installed):

pip install requests Pillow --break-system-packages

Create temp directory:

mkdir -p /home/claude/temp_images

Download images:

Option A - Single Image:

python scripts/fetch_image.py
"https://example.com/sap-screenshot.png"
/home/claude/temp_images

Option B - Multiple Images (Recommended):

Create URL list

cat > /home/claude/image_urls.txt << 'EOF' https://example.com/sap-vov8.png https://example.com/sales-flow.jpg https://example.com/config-screen.png EOF

Download all at once

python scripts/fetch_images_batch.py
/home/claude/image_urls.txt
/home/claude/temp_images

Step 4.4: Verify Downloads

ls -lh /home/claude/temp_images/

You should see the downloaded images with file sizes.

5. Document Creation with Embedded Images

Follow the docx skill guidelines to create a professional Word document.

Key requirements for images in the document:

• Embed images using the docx library according to the docx skill instructions

• Use the downloaded image paths from /home/claude/temp_images/

• Add figure captions below each image:

• Format: "Figure X: [Description]"

• Example: "Figure 1: SAP Transaction VOV8 - Sales Document Type Configuration"

• Center-align images

• Resize to appropriate width (typically 600px for full-width images)

Example embedding pattern (following docx skill):

After creating document according to docx skill

Add image paragraph with the downloaded image

See docx SKILL.md for exact syntax

6. Document Formatting Standards

Title Page:

• Article title (Heading 1, SAP blue #0070AD)

• Subtitle

• Date and version

Content Formatting:

• Headings: Hierarchical (H1: 16pt SAP blue, H2: 14pt, H3: 12pt)

• Paragraphs: 11pt Calibri, 1.15 line spacing

• Transaction codes: Monospace font (Courier New), light gray background

• Tables: Professional borders, header row with SAP blue background

• Lists: Bullet points or numbered lists as appropriate

Images:

• 600px width for full-width images

• Figure captions below each image

• Center-aligned

• Minimum 2-3 images per article

References Section:

• Numbered list of all sources

• Format: [1] Source Title, URL, Accessed: YYYY-MM-DD

7. Quality Assurance Checklist

Before delivering, verify:

• Read docx SKILL.md completely

• Performed 2-3+ web searches for fact-checking

• Downloaded 2-3+ relevant images

• Images properly embedded with captions

• All transaction codes verified

• Table of contents generated (if applicable)

• References section complete

• Professional formatting throughout

• Saved to /mnt/user-data/outputs/

8. Delivery

Save document to outputs

Filename: [Topic]_SAP_Guide.docx

mv /home/claude/article.docx /mnt/user-data/outputs/SAP_[Topic]_Guide.docx

Provide user with:

• Computer link: computer:///mnt/user-data/outputs/SAP_[Topic]_Guide.docx

• Brief summary of included content

Built-in Image Fetching Scripts

This skill includes two Python scripts for downloading images:

scripts/fetch_image.py

Downloads a single image from a URL.

Usage:

python scripts/fetch_image.py <image_url> [output_dir] [filename]

Examples:

Download to current directory

python scripts/fetch_image.py https://example.com/image.jpg

Download to specific directory

python scripts/fetch_image.py https://example.com/image.jpg /home/claude/temp_images

Download with custom filename

python scripts/fetch_image.py https://example.com/image.jpg /home/claude/temp_images sap_screenshot.jpg

scripts/fetch_images_batch.py

Downloads multiple images from a list.

Usage:

python scripts/fetch_images_batch.py <urls_file> [output_dir]

Input file: Text file with one URL per line, or JSON array

Example:

python scripts/fetch_images_batch.py urls.txt /home/claude/temp_images

Common SAP Topics

This skill handles articles on:

• SD: Sales orders, pricing, delivery, billing, consignment

• MM: Procurement, inventory, material master, consignment

• FI: General ledger, accounts payable/receivable, asset accounting

• CO: Cost centers, profit centers, internal orders

• PP: Production planning, work centers, BOMs, confirmations

• WM: Warehouse management, storage bins, transfers

• Technical: ABAP, OData APIs, IDocs, BAPIs, RFCs, CDS views

• Basis: Data archiving (SARA), transports, system administration

• S/4HANA: Fiori apps, embedded analytics, simplifications

Complete Example Workflow

User Request: "Create an article on SAP sales order type configuration"

Step-by-step execution:

Read docx skill:

cat /mnt/skills/public/docx/SKILL.md

Research (3 web searches):

web_search("SAP SD sales order type configuration VOV8") web_search("SAP sales document types customizing") web_search("SAP S/4HANA order type setup")

Find images (2 web searches):

web_search("SAP transaction VOV8 screenshot") web_search("SAP sales order flow diagram")

Download images:

mkdir -p /home/claude/temp_images

cat > /home/claude/urls.txt << 'EOF' https://sap-blog.com/vov8-screenshot.png https://sap-tutorial.com/sales-flow.jpg EOF

python scripts/fetch_images_batch.py /home/claude/urls.txt /home/claude/temp_images

ls -lh /home/claude/temp_images/

Create Word document following docx skill with:

• Title page

• Table of contents

• Introduction

• Configuration steps

• Embedded images from /home/claude/temp_images/

• Testing procedures

• References section

Save and deliver:

Document saved during creation to:

/mnt/user-data/outputs/SAP_Sales_Order_Types_Configuration_Guide.docx

Troubleshooting

Issue: Images not downloading

• Check URLs are direct image links

• Verify network connectivity

• Try alternative image sources

• Some sites block automated downloads

Issue: Image format not supported

• Script supports: JPG, PNG, GIF, WebP, BMP, SVG, TIFF

• Auto-detects format from content-type header

Issue: Images not embedding in Word

• Verify image files exist in /home/claude/temp_images/

• Check file paths are correct

• Follow docx skill instructions exactly for embedding

Issue: Python dependencies missing

pip install requests Pillow --break-system-packages

Critical Reminders

• ALWAYS read docx SKILL.md first before creating any Word document

• ALWAYS fact-check with 2-3+ web searches

• ALWAYS download and embed 2-3+ images - this is not optional

• ALWAYS cite sources in the references section

• ALWAYS use proper SAP formatting (transaction codes in monospace)

• ALWAYS save to /mnt/user-data/outputs/ for user access

• ALWAYS verify image downloads before embedding

Success Criteria

A successful SAP article includes: ✅ 2000-4000 words of fact-checked content

✅ 2-3+ embedded images with captions

✅ Professional Word document formatting

✅ SAP-specific styling (blue headers, monospace codes)

✅ Step-by-step instructions with transaction codes

✅ References section with 3-5+ sources

✅ Saved to /mnt/user-data/outputs/ with proper filename