qa-analysis

Run segment-level question-answering analysis on specific document segments.

36|18|Updated Nov 23, 2025
One-click install
npx skills add https://github.com/aws-samples/sample-aws-idp-pipeline --skill qa-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-analysis
Source: https://github.com/aws-samples/sample-aws-idp-pipeline/tree/main/packages/agents/idp-agent/.skills/qa-analysis
Command: npx skills add https://github.com/aws-samples/sample-aws-idp-pipeline --skill qa-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When users need more detailed answers about a specific part of a document, they often have to re-check pages manually and re-prompt repeatedly to get the right level of depth.

Core Features & Use Cases

  • Targeted segment QA: Detects the relevant document and segment from conversation context to focus analysis precisely.
  • Segment-aware workflow: Handles both single-segment documents automatically and multi-segment documents by prompting the user to choose which segment to analyze.
  • Adds richer document QA: Submits the user’s follow-up question to a dedicated QA function and returns the deeper analysis result for that segment.

Quick Start

Ask the assistant for additional analysis about a specific document or page segment by saying what you want to know next (for example, “additional analysis of the conclusion paragraph”).

Frequently Asked Questions about qa-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ask follow-up questions about a specific section of a document?

To ask follow-up questions about a specific document section, request additional analysis on that segment. The assistant resolves the target document_id, selects the correct segment_index, and runs segment-level QA to return deeper analysis results.

What happens when I request deeper analysis on a multi-page document?

When requesting deeper analysis on multi-page documents, the assistant retrieves segment counts using get_document_segments. For multi-segment documents, it prompts you to choose which segment to analyze, then submits your question via add_document_qa.

Can I get targeted question-answering analysis on a single document segment automatically?

Yes, targeted question-answering analysis works automatically for single-segment documents. The assistant detects the relevant document and segment from conversation context and directly runs segment-level QA without prompting for segment selection.

What's the best way to resolve context when asking questions about a specific document paragraph?

The best way to resolve context for specific document paragraph questions is relying on the assistant's context resolution. It detects the target document_id from the conversation, selects the matching segment, and submits your follow-up question for deeper investigation.

How does segment selection work for document QA analysis?

Segment selection for document QA analysis works by retrieving segment counts first, then using get_document_segments to identify the correct segment_index. For multi-segment documents, the assistant prompts you to choose; single-segment documents are handled automatically.

Do I need to specify the segment index when requesting additional analysis of a conclusion paragraph?

You do not need to specify the segment index yourself. The assistant resolves the target document from conversation context, retrieves segments, and either selects the correct segment automatically or prompts you to choose which segment to analyze.