Claude Skill

AndroidAPS Book Illustration Director

Skill Version: 1.0.0
Skill ID: com.androidaps.book-illustration-director
Author: Medical Documentation Team
License: CC-BY-SA-4.0
Status: Production Ready

Skill Description

The AndroidAPS Book Illustration Director is a professional-grade Claude Skill designed to generate comprehensive illustration specifications, technical diagrams, UI mockups, and visual specifications for medical books, clinician handbooks, patient guides, and technical manuals.

This skill empowers authors and documentation teams to create publication-ready illustration briefs that maintain consistency, medical accuracy, and accessibility across entire book series. The skill integrates with professional illustration tools including Claude Vision, DALL·E, Midjourney, Adobe Firefly, and works with both AI-powered and human illustrators.

Skill Capabilities

Primary Functions

1. Illustration Specification Generation

   • Create detailed, AI-ready illustration briefs
   • Generate precise figure captions
   • Produce accessibility descriptions and alt text
   • Define composition, perspective, and styling requirements

2. Workflow Diagram Specification

   • Decision trees and flowcharts
   • Technical system architecture diagrams
   • Device communication flows (Bluetooth, CGM, pump)
   • AndroidAPS closed-loop algorithm visualization

3. UI Mockup Generation

   • AndroidAPS screen specifications
   • Android Material Design compliance
   • Navigation hierarchy documentation
   • Button, icon, and spacing definitions

4. Medical Illustration Guidance

   • Patient anatomy illustrations
   • Device illustrations
   • Interaction demonstrations
   • Safety and procedure visuals

5. Medical Diagram Creation

   • Comparison tables and matrices
   • Callout boxes and annotations
   • Data visualization specifications
   • Infographic specifications

6. Quality Assurance & Validation

   • Style consistency verification
   • Technical accuracy checking
   • Accessibility compliance validation
   • Print readiness assessment

Design System Integration

The skill implements a cohesive visual identity inspired by:

• Apple Human Interface Guidelines: Clean, minimal design philosophy
• Dexcom Documentation: Medical device presentation standards
• Abbott Libre Documentation: User-friendly medical visualizations
• Medtronic Manuals: Clinical illustration excellence
• Tandem Diabetes Care Documentation: Diabetes technology standards

Visual Characteristics

• Flat vector illustration style
• Clean white backgrounds
• Medical blue color palette (#0066CC primary)
• Rounded corners (8px standard radius)
• Minimal, intentional shadows
• Modern sans-serif typography (Roboto, Inter, Helvetica Neue)
• Clinical realism with approachability
• High readability and clarity
• Accessibility-first design principles
• Consistent spacing and alignment (8px grid)
• Professional publishing-grade quality

Target Audiences

This skill supports creation of illustrations for:

• Patients: User-friendly, non-technical visualization
• Clinicians: Detailed, medically accurate diagrams
• Technical Users: System architecture and configuration diagrams
• Healthcare Students: Educational medical illustrations
• Book Readers: Publication-quality chapter illustrations

Installation & Usage

System Requirements

• Claude AI (Web, Desktop, or API)
• Access to Claude Skills catalog
• Markdown rendering capability
• GitHub integration (optional, for asset management)

Basic Usage Pattern

When enabled, this skill activates automatically when:

1. You request illustration specifications for a chapter
2. You ask for diagram specifications
3. You need UI mockup definitions
4. You require medical illustration briefs
5. You need accessibility descriptions

Example activation:

"Create illustrations for Chapter 3: Continuous Glucose Monitoring"

The skill automatically generates:

• Illustration specifications with AI prompts
• Workflow diagrams for sensor operation
• UI mockups for CGM configuration
• Medical illustrations of glucose sensing
• Accessibility descriptions
• Quality checklist

Manual Specification

Create a specification request using:

[ILLUSTRATION REQUEST]
Title: [Chapter/Section Title]
Type: [illustration|diagram|mockup|medical]
Context: [Brief description]
[Additional parameters]

Skill Behavior

Automatic Features

When a specification is requested, the skill:

1. ✓ Generates illustration ID and metadata
2. ✓ Defines composition and perspective
3. ✓ Specifies lighting and background
4. ✓ Produces color palette with hex codes
5. ✓ Creates typography specifications
6. ✓ Defines icons and labels
7. ✓ Generates callout annotations
8. ✓ Produces accessibility descriptions
9. ✓ Creates figure captions
10. ✓ Generates alt text
11. ✓ Provides illustrator notes
12. ✓ Creates AI image prompts (positive and negative)
13. ✓ Produces quality checklist
14. ✓ Validates against style guidelines

Output Format

All specifications are generated in Markdown format with:

• Structured headers and sections
• YAML frontmatter for metadata
• Inline code for technical specifications
• Syntax-highlighted examples
• Hyperlinked references to design system
• Copy-paste ready AI prompts

Reference Documentation

The skill includes comprehensive reference materials:

Design Standards

• references/illustration-style.md - Visual style guidelines
• references/color-system.md - Color palette and hex codes
• references/composition.md - Composition principles
• references/camera-perspective.md - Perspective and viewpoint guidelines
• references/lighting.md - Lighting specifications
• references/typography.md - Font and text specifications

Medical & Technical

• references/medical-icons.md - Icon library and usage
• references/androidaps-ui.md - UI component specifications
• references/medical-device-rules.md - Medical device illustration standards
• references/patient-illustrations.md - Patient representation guidelines
• references/doctor-illustrations.md - Healthcare professional representation
• references/technical-illustrations.md - Technical accuracy requirements

Diagramming

• references/workflow-diagrams.md - Workflow specification standards
• references/flowcharts.md - Flowchart symbols and logic
• references/tables.md - Table design and data visualization
• references/callout-boxes.md - Annotation and callout standards

Quality & Accessibility

• references/accessibility.md - WCAG 2.1 compliance
• references/quality-checklist.md - Pre-publication validation

Template Library

Reusable templates for rapid specification creation:

• templates/illustration-template.md - General illustration specification
• templates/workflow-template.md - Workflow diagram specification
• templates/ui-mockup-template.md - UI specification
• templates/table-template.md - Data visualization table
• templates/diagram-template.md - Technical diagram specification

Example Specifications

Complete, production-ready examples:

• examples/patient-handbook/ - Patient guide illustrations
• examples/clinician-handbook/ - Clinical manual illustrations
• examples/technical-manual/ - Configuration guide illustrations
• examples/androidaps-ui/ - Screen mockup examples
• examples/workflows/ - Workflow diagram examples
• examples/medical/ - Medical illustration examples

Validation System

Each specification passes through automated validation:

✓ Style Consistency Check
✓ Technical Accuracy Verification
✓ Clinical Clarity Assessment
✓ Accessibility Compliance Check
✓ Print Readiness Validation
✓ AI Prompt Completeness
✓ Publication Quality Standards

Every Specification Includes

Each generated illustration specification contains:

• Illustration ID: Unique identifier (e.g., ILLS-CH03-001)
• Title: Clear, descriptive title
• Purpose: Why this illustration is needed
• Educational Objective: What the reader should learn
• Target Audience: Primary intended viewer
• Placement: Chapter, section, and context
• Composition: Visual layout and element positioning
• Camera Perspective: Viewpoint and scale
• Lighting: Light direction and intensity
• Background: Background element specifications
• Color Palette: Named colors with hex codes
• Typography: Font, size, weight, color
• Icons: Icon specifications and sources
• Labels: Text labels and positioning
• Callouts: Annotation specifications
• Accessibility Notes: Alt text, descriptions, semantic information
• Figure Caption: Publication-ready caption
• Alt Text: Screen reader friendly description
• Illustrator Notes: Guidance for human illustrators
• AI Image Prompt: Detailed positive prompt
• Negative Prompt: What to avoid
• Quality Checklist: Validation criteria

Integration with AI Image Generators

Specifications can be used directly with:

• Claude Vision - For image analysis and iteration
• DALL·E 3 - E2E image generation
• Midjourney - Professional illustration generation
• Adobe Firefly - Design system integration
• Canva - Template-based creation
• Professional Illustrators - As detailed briefs

Use Cases

1. Patient Handbook Illustration

Author: "Create illustrations for the Patient Handbook chapter on insulin pump basics"

Generated:

• Insulin pump anatomy illustration
• Infusion set insertion procedure
• Screen navigation mockups
• Safety callout boxes
• Diabetes management workflow diagram

2. Clinician Reference Manual

Author: "Generate clinical diagrams for the CGM accuracy chapter"

Generated:

• Blood glucose vs CGM comparison chart
• Sensor accuracy visualization
• Glucose trend analysis diagram
• Clinical decision tree flowchart
• Data interpretation callouts

3. Technical Configuration Guide

Author: "Create UI specifications for the AndroidAPS settings chapter"

Generated:

• Settings screen mockups
• Navigation hierarchy diagram
• Configuration workflow
• Button and control specifications
• Alert and notification designs

4. Educational Medical Illustration

Author: "Illustrate the closed-loop algorithm for medical students"

Generated:

• Algorithm flowchart
• CGM data acquisition diagram
• Insulin delivery logic diagram
• System architecture visualization
• Educational callout annotations

Version History

v1.0.0 (Current)

• ✓ Initial production release
• ✓ Complete reference documentation
• ✓ Full template library
• ✓ Comprehensive example specifications
• ✓ Built-in validation system
• ✓ Medical accuracy standards
• ✓ Accessibility compliance
• ✓ Professional quality assurance

Support & Resources

Documentation

• README.md - Getting started guide
• LICENSE - CC-BY-SA-4.0 licensing information
• CHANGELOG.md - Version history and updates

File Structure

AndroidAPS-Book-Illustration-Director/
├── SKILL.md                          # This file
├── README.md                         # User guide
├── LICENSE                           # CC-BY-SA-4.0
├── CHANGELOG.md                      # Version history
├── references/                       # Design system standards
│   ├── illustration-style.md
│   ├── color-system.md
│   ├── composition.md
│   ├── camera-perspective.md
│   ├── lighting.md
│   ├── medical-icons.md
│   ├── androidaps-ui.md
│   ├── workflow-diagrams.md
│   ├── flowcharts.md
│   ├── tables.md
│   ├── callout-boxes.md
│   ├── typography.md
│   ├── medical-device-rules.md
│   ├── patient-illustrations.md
│   ├── doctor-illustrations.md
│   ├── technical-illustrations.md
│   ├── accessibility.md
│   └── quality-checklist.md
├── templates/                        # Reusable templates
│   ├── illustration-template.md
│   ├── workflow-template.md
│   ├── ui-mockup-template.md
│   ├── table-template.md
│   └── diagram-template.md
├── examples/                         # Production examples
│   ├── patient-handbook/
│   ├── clinician-handbook/
│   ├── technical-manual/
│   ├── androidaps-ui/
│   ├── workflows/
│   └── medical/
├── assets/                           # Design assets
│   ├── color-palette.json
│   ├── icons/
│   └── templates/
└── validation/                       # QA system
    ├── validator.md
    └── checklist-complete.md

Compliance & Standards

• ✓ WCAG 2.1 Level AA: Accessibility compliance
• ✓ Medical Accuracy: Evidence-based medical illustration
• ✓ Clinical Standards: FDA medical device documentation
• ✓ Publishing Standards: Print-ready specifications
• ✓ Design Systems: Modern UI/UX best practices
• ✓ AI Prompt Optimization: Production-grade prompts

License

This skill is released under the CC-BY-SA-4.0 (Creative Commons Attribution-ShareAlike 4.0 International) license, allowing free use, adaptation, and distribution with attribution and reciprocal licensing.

Next Steps

1. Install the Skill - Add to your Claude account via the Skills marketplace
2. Review Examples - Explore examples/ directory for use cases
3. Read References - Study the design system in references/
4. Use Templates - Apply templates for faster specification creation
5. Generate Specifications - Start requesting illustration specifications

Last Updated: 2026-07-23
Status: Production Ready
Skill ID: com.androidaps.book-illustration-director
Version: 1.0.0