Qdrant File Exporter

Extracts all text chunks with three-tier contextual embeddings from a specific PDF file stored in the Qdrant vector database and saves them to a plain text file.

When to Use This Skill

Activate this skill when the user:

• •Wants to extract all chunks from a specific PDF
• •Asks to export, dump, or save chunks from a document
• •Needs to view all chunk content for a file
• •Wants to analyze chunks outside of the vector database
• •Needs to review or inspect the three-tier contextual embeddings
• •Wants to see how chunks were contextualized during loading
• •Says things like "export chunks from [filename]" or "dump all chunks for [file]"

How to Use

Step 1: Get the PDF Filename

Ask the user which PDF file they want to export chunks from. The filename should match exactly what's stored in the Qdrant doc field (e.g., "bcy-26-income-eligibility-and-maximum-psoc-twc.pdf").

If the user doesn't know the exact filename, suggest using the qdrant-chunk-retriever skill first to search for files.

Step 2: Run the Export Script

Execute the Python helper script:

python .claude/skills/qdrant-file-exporter/scripts/export_chunks.py "filename.pdf"

The script will:

1. •Connect to Qdrant (tro-child-3-contextual collection)
2. •Retrieve all chunks matching the filename
3. •Save them to UTIL/[filename]_chunks.txt

Step 3: Report Results

After the script completes, inform the user:

• •Total number of chunks extracted
• •Output file location
• •File size (if available)
• •Mention that contexts are included

Example:

✅ Extracted 47 chunks from bcy-26-income-eligibility-and-maximum-psoc-twc.pdf
📄 Saved to: UTIL/bcy-26-income-eligibility-and-maximum-psoc-twc_chunks.txt
📊 Includes master context, document context, and chunk-specific contexts

Step 4: Offer Next Steps

Ask the user if they want to:

• •View the exported file
• •Export another PDF
• •Analyze the chunk content

Examples

Example 1: Basic Export

User: "Export all chunks from the income eligibility PDF"
Assistant: "Which PDF would you like to export? Please provide the exact filename."
User: "bcy-26-income-eligibility-and-maximum-psoc-twc.pdf"
Assistant: *Runs export script*
          "✅ Extracted 47 chunks from bcy-26-income-eligibility-and-maximum-psoc-twc.pdf
           📄 Saved to: UTIL/bcy-26-income-eligibility-and-maximum-psoc-twc_chunks.txt"

Example 2: Export for Analysis

User: "I need to see all the chunks for the PSOC chart document"
Assistant: *Runs export script with bcy-26-psoc-chart-twc.pdf*
          "✅ Extracted 12 chunks from bcy-26-psoc-chart-twc.pdf
           📄 Saved to: UTIL/bcy-26-psoc-chart-twc_chunks.txt

           Would you like me to open the file or analyze the content?"

Error Handling

File Not Found in Qdrant

If the PDF filename doesn't match any documents:

• •Suggest the user check the filename spelling
• •Recommend using qdrant-chunk-retriever to search for available files
• •List similar filenames if possible

Connection Errors

If Qdrant connection fails:

• •Check QDRANT_API_URL and QDRANT_API_KEY environment variables
• •Verify the collection name (tro-child-3-contextual) exists
• •Suggest running python LOAD_DB/verify_qdrant.py to check connection

No Chunks Found

If the file exists but has 0 chunks:

• •Verify the file was loaded correctly
• •Suggest running the loader script if needed

Dependencies

• •Qdrant client (qdrant-client)
• •Environment variables: QDRANT_API_URL, QDRANT_API_KEY
• •Collection: tro-child-3-contextual (must exist)

Output Format

The exported text file contains:

• •Master Context (once at beginning): Domain-level context for all chunks
• •Document Context (once at beginning): Document-specific summary
• •Chunks in original document order (sorted by chunk_index from loading pipeline)
  • •Header: --- Chunk N (Page X) ---
  • •Chunk-specific context: [Chunk Context]: ...
  • •Plain text content
• •Starts from the beginning of the document