Pagans — Development skill for Claude Code

PAGANS - Prompt Optimization Framework

[](https://pypi.org/project/pagans/) [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) [](https://github.com/abubakarsiddik31/pagans/actions/workflows/build.yml) [](https://github.com/abubakarsiddik31/pagans/actions/workflows/test.yml) [](https://github.com/abubakarsiddik31/pagans/actions/workflows/lint.yml)

PAGANS (Prompts Aligned to Guidelines and Normalization System) is a prompt optimization framework for LLM applications. It adapts prompts to the target model family automatically so the same prompt can perform better across OpenAI, Anthropic, Google, and xAI model series.

Features

• Fast prompt optimization for production workflows
• Family-aware optimization for OpenAI, Anthropic, Google, and xAI models
• Automatic model-family detection from short and provider-prefixed names
• Async-first API for single, compare, and batch operations
• Built-in caching to reduce repeated optimization cost
• CLI support for optimize, compare, and batch workflows
• Optimizer provider support for OpenRouter, OpenAI, Google AI Studio, Anthropic, and Z.ai

Installation

pip install pagans

Quick Start

import asyncio

from pagans import PAGANSOptimizer, Provider


async def main() -> None:
    async with PAGANSOptimizer(provider=Provider.OPENROUTER) as optimizer:
        result = await optimizer.optimize(
            prompt="Write a robust retry policy