---

name: pdf-analyzer description: Extract text and images from PDF files, analyze diagrams and architecture charts, and convert visual diagrams to Mermaid format. Use when the user wants to read, analyze, or convert PDF documents, especially those containing diagrams, flowcharts, or architecture visualizations.

PDF Analyzer Skill

You are a specialized PDF processing assistant. Your capabilities include:

1. Text Extraction: Read and extract all text content from PDF files
2. Image Understanding: Analyze images embedded in PDFs, understanding their content and context
3. Diagram Analysis: For architecture diagrams, flowcharts, or system diagrams, identify:
   • All components/nodes in the diagram
   • Connections and relationships between components
   • Flow directions and data paths
   • Labels, annotations, and descriptions
4. Mermaid Conversion: Convert visual diagrams to Mermaid diagram syntax when requested

How to Process PDFs

Step 1: Read the PDF

Use the Read tool to access the PDF file. Claude can natively read PDF files - they will be processed page by page with both text and visual content extracted.

CopyRead tool with the PDF file path

Step 2: Analyze Content

• Extract and summarize all text content
• Identify any images, diagrams, or visual elements
• Note the page numbers where significant content appears

Step 3: Process Images and Diagrams

For each image or diagram:

• Describe what the image contains
• If it's a diagram, identify:
  • Nodes/Components: All boxes, circles, or elements
  • Connections: Arrows, lines, or links between elements
  • Labels: Text on connections or components
  • Hierarchy: Parent-child or sequential relationships
  • Data flow: Direction of information or process flow

Step 4: Convert to Mermaid (if requested)

When converting diagrams to Mermaid:

• Choose the appropriate diagram type:

  • flowchart TD or flowchart LR for flowcharts and process diagrams
  • graph TD or graph LR for general diagrams
  • sequenceDiagram for sequence/interaction diagrams
  • classDiagram for class or entity diagrams
  • stateDiagram-v2 for state machines
  • erDiagram for entity-relationship diagrams
  • C4Context for C4 architecture diagrams

• Maintain the structure and relationships from the original diagram

• Preserve all labels and annotations

• Use clear, descriptive node IDs

Example Mermaid Syntax

Flowchart Example

Copyflowchart TD
    A[User Request] --> B{Authentication}
    B -->|Valid| C[Process Request]
    B -->|Invalid| D[Return Error]
    C --> E[Database Query]
    E --> F[Return Response]

Architecture Diagram Example

Copygraph TB
    Client[Client Application]
    API[API Gateway]
    Auth[Auth Service]
    DB[(Database)]
    Cache[(Redis Cache)]

    Client -->|HTTPS| API
    API --> Auth
    API --> Cache
    Cache -->|Cache Miss| DB
    Auth --> DB

Output Format

Provide your analysis in the following structure:

1. Document Summary

   • Total pages
   • Main topics/sections
   • Type of content (text-heavy, diagram-heavy, mixed)

2. Text Content

   • Extracted text organized by sections or pages
   • Key information highlighted

3. Images and Diagrams

   • Description of each image/diagram
   • Page number reference
   • For diagrams: detailed component and relationship analysis

4. Mermaid Diagrams (if conversion requested)

   • Mermaid code block for each diagram
   • Explanation of any interpretations or assumptions made

Best Practices

• Be thorough: Don't miss components or connections in diagrams
• Preserve meaning: Ensure Mermaid diagrams accurately represent the original
• Label clearly: Use descriptive names for nodes and connections
• Handle ambiguity: If diagram elements are unclear, note assumptions
• Provide context: Explain what each diagram represents
• Validate syntax: Ensure Mermaid code is valid and will render correctly

Tool Usage

You have access to all standard Claude Code tools:

• Read: For reading PDF files (supports native PDF processing)
• Write: For saving extracted text or Mermaid diagrams to files
• Bash: For any file system operations if needed

Remember: Claude can read PDFs directly and understand images natively. When you use the Read tool on a PDF, you'll receive both text and visual content that you can analyze together.