---
title: Guides
---

# Guides

These guides walk you through SCRAPI's major workflows in depth. Whether you're building your first agent, setting up evaluations, or integrating AI skills into your development process, you'll find step-by-step guidance here.

## Where to Start

If you're new to SCRAPI, we recommend working through these guides in order:

<div class="grid cards" markdown>

-   **Agent Development**

    ---

    Learn the core workflow: creating agents, pulling and pushing code, and managing resources like tools, callbacks, and guardrails.

    [:octicons-arrow-right-24: Start building](agent-development/index.md)

-   **Agent Migration & Optimization**

    ---

    Automatically convert Dialogflow CX flows and playbooks into modular CXAS agents, complete with topology analysis and complete app optimization.

    [:octicons-arrow-right-24: Start migrating](migration/index.md)

-   **Testing & Evaluation**

    ---

    SCRAPI offers five evaluation types for testing your agents — from deterministic golden tests to AI-driven simulations.

    [:octicons-arrow-right-24: Set up testing](evaluation/index.md)

-   **Linting**

    ---

    Catch issues early with 60+ built-in lint rules covering instructions, callbacks, tools, evaluations, and app structure.

    [:octicons-arrow-right-24: Configure linting](linting/index.md)

-   **AI Skills**

    ---

    Supercharge your workflow with AI-assisted agent building, testing, and debugging — powered by Claude Code or Gemini CLI.

    [:octicons-arrow-right-24: Explore skills](skills/index.md)

-   **Insights**

    ---

    Work with CXAS Quality AI scorecards to track and improve agent performance over time.

    [:octicons-arrow-right-24: View insights](insights/index.md)

</div>