How do I install the Modify Agent Prompts skill?

Run npx skillmds@latest add aws-samples/modify-agent-prompts in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Modify Agent Prompts safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Modify Agent Prompts?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Modify Agent Prompts free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Modify Agent Prompts?

aws-samples (@aws-samples) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Modify Agent Prompts by aws-samples

Name: Modify Agent Prompts
Author: aws-samples

Modify Agent Prompts

Modify the review-item-processor agent's prompts, model configuration, confidence thresholds, JSON output schemas, and tool setup. Use when changing document or image review prompts, adjusting model IDs, modifying output format, updating citation settings, or adding new tools to the agent.

aws-samples e8d34a9 2 files · 6.1 KB Updated Sep 17, 2026

File contents

Modify Agent Prompts and Configuration

Agent Architecture

review-item-processor/
├── agent.py               # Prompt generators + agent execution
├── model_config.py        # Model registry with capabilities
├── tools/
│   ├── factory.py         # Dynamic tool creation
│   ├── knowledge_base.py  # Bedrock KB integration
│   ├── code_interpreter.py
│   └── mcp_tool.py        # MCP tool support
└── index.py               # Lambda handler entry point

Common Modifications

1. Modifying Document Review Prompts

File: agent.py

Key functions:

get_document_review_prompt() - Main entry point
_get_document_review_prompt_with_citations() - With citations
_get_document_review_prompt_legacy() - Without citations

JSON Schema:

{
  "result": "pass" | "fail",
  "confidence": <number 0-1>,
  "explanation": "<detailed reasoning>",
  "shortExplanation": "<max 80 chars>",
  "pageNumber": <integer from 1>,
  "citations": ["<quoted text>", ...]
}

2. Modifying Image Review Prompts

File: agent.py, function get_image_review_prompt()

JSON Schema (Nova models add boundingBoxes):

{
  "result": "pass" | "fail",
  "confidence": <number 0-1>,
  "explanation": "<detailed reasoning>",
  "shortExplanation": "<max 80 chars>",
  "usedImageIndexes": [<list of indexes>]
}

3. Model Configuration

Environment Variables (set in CDK):

DOCUMENT_PROCESSING_MODEL_ID, IMAGE_REVIEW_MODEL_ID, BEDROCK_REGION
ENABLE_CITATIONS, ENABLE_CODE_INTERPRETER

Change models via CDK:

cdk deploy -c rapid.documentProcessingModelId="global.anthropic.claude-opus-4-6-v1"

Add new model to model_config.py in _get_model_configs():

"model-id": ModelConfig(
    model_id="model-id",
    supports_document_block=True,
    supports_citation=True,
    supports_caching=True,
    input_per_1k=0.XXX,
    output_per_1k=0.XXX,
)

4. Adding New Environment Variables

Define in cdk/lib/parameter-schema.ts
Pass to Lambda in cdk/lib/constructs/agent.ts
Read in agent.py with os.environ.get()

5. Adding New Tools

For detailed tool creation guide, see references/TOOL-CREATION.md.

Quick Reference

Modification	Location	Search For
Document prompt schema	agent.py	`_get_document_review_prompt`
Image prompt schema	agent.py	`get_image_review_prompt`
Confidence guidelines	agent.py	`confidence_guidelines`
Tool usage instructions	agent.py	`_build_tool_usage_section`
Model capabilities	model_config.py	`_get_model_configs`
Environment variables	CDK agent.ts	`environment:`

Troubleshooting

Issue	Check
Citations not working	`ENABLE_CITATIONS` env var, model supports citations in `model_config.py`
Model not found	Model ID format, available in `BEDROCK_REGION`, added to `model_config.py`
Tool not available	Tool configuration in event payload, registered in `factory.py`
Wrong output format	JSON schema in prompt, `{language_name}` placeholders

After Modification

Run /build-and-format if Python code changed
Run /deploy-cdk-stack if CDK changes made
Test with sample documents and monitor CloudWatch logs

---name: modify-agent-promptsdescription: Modify the review-item-processor agent's prompts, model configuration, confidence thresholds, JSON output schemas, and tool setup. Use when changing document or image review prompts, adjusting model IDs, modifying output format, updating citation settings, or adding new tools to the agent.---# Modify Agent Prompts and Configuration## Agent Architecture```review-item-processor/├── agent.py # Prompt generators + agent execution├── model_config.py # Model registry with capabilities├── tools/│ ├── factory.py # Dynamic tool creation│ ├── knowledge_base.py # Bedrock KB integration│ ├── code_interpreter.py│ └── mcp_tool.py # MCP tool support└── index.py # Lambda handler entry point```## Common Modifications### 1. Modifying Document Review Prompts**File**: `agent.py`Key functions:- `get_document_review_prompt()` - Main entry point- `_get_document_review_prompt_with_citations()` - With citations- `_get_document_review_prompt_legacy()` - Without citations**JSON Schema**:```python{ "result": "pass" | "fail", "confidence": <number 0-1>, "explanation": "<detailed reasoning>", "shortExplanation": "<max 80 chars>", "pageNumber": <integer from 1>, "citations": ["<quoted text>", ...]}```### 2. Modifying Image Review Prompts**File**: `agent.py`, function `get_image_review_prompt()`**JSON Schema** (Nova models add `boundingBoxes`):```python{ "result": "pass" | "fail", "confidence": <number 0-1>, "explanation": "<detailed reasoning>", "shortExplanation": "<max 80 chars>", "usedImageIndexes": [<list of indexes>]}```### 3. Model Configuration**Environment Variables** (set in CDK):- `DOCUMENT_PROCESSING_MODEL_ID`, `IMAGE_REVIEW_MODEL_ID`, `BEDROCK_REGION`- `ENABLE_CITATIONS`, `ENABLE_CODE_INTERPRETER`**Change models via CDK**:```bashcdk deploy -c rapid.documentProcessingModelId="global.anthropic.claude-opus-4-6-v1"```**Add new model** to `model_config.py` in `_get_model_configs()`:```python"model-id": ModelConfig( model_id="model-id", supports_document_block=True, supports_citation=True, supports_caching=True, input_per_1k=0.XXX, output_per_1k=0.XXX,)```### 4. Adding New Environment Variables1. Define in `cdk/lib/parameter-schema.ts`2. Pass to Lambda in `cdk/lib/constructs/agent.ts`3. Read in `agent.py` with `os.environ.get()`### 5. Adding New ToolsFor detailed tool creation guide, see [references/TOOL-CREATION.md](references/TOOL-CREATION.md).## Quick Reference| Modification | Location | Search For ||--------------|----------|------------|| Document prompt schema | agent.py | `_get_document_review_prompt` || Image prompt schema | agent.py | `get_image_review_prompt` || Confidence guidelines | agent.py | `confidence_guidelines` || Tool usage instructions | agent.py | `_build_tool_usage_section` || Model capabilities | model_config.py | `_get_model_configs` || Environment variables | CDK agent.ts | `environment:` |## Troubleshooting| Issue | Check ||-------|-------|| Citations not working | `ENABLE_CITATIONS` env var, model supports citations in `model_config.py` || Model not found | Model ID format, available in `BEDROCK_REGION`, added to `model_config.py` || Tool not available | Tool configuration in event payload, registered in `factory.py` || Wrong output format | JSON schema in prompt, `{language_name}` placeholders |## After Modification1. Run `/build-and-format` if Python code changed2. Run `/deploy-cdk-stack` if CDK changes made3. Test with sample documents and monitor CloudWatch logs

Frequently asked questions