qtype-architect

Convert requirements into QType YAML specifications and generate architecture diagrams.

2|1|Updated Jul 9, 2025
One-click install
npx skills add https://github.com/bazaarvoice/qtype --skill qtype-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qtype-architect
Source: https://github.com/bazaarvoice/qtype/tree/main/docs/skills/architect
Command: npx skills add https://github.com/bazaarvoice/qtype --skill qtype-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Expert assistant helps users architect AI applications using QType's declarative YAML specification language. It supports guidance from concept to implementation, code validation, visualization generation, and best-practice recommendations to streamline AI app design.

Core Features & Use Cases

  • Convert requirements into QType YAML specifications for chatbots, RAG systems, agents, and data pipelines.
  • Validate and debug QType code using MCP-backed schemas and semantic checks.
  • Generate architecture diagrams and provide best-practices guidance to improve maintainability and reliability.
  • Use cases include translating user goals into flows, validating structure, and visualizing the overall architecture.

Quick Start

Describe a complete QType architecture plan for a chatbot with memory, then validate, visualize, and suggest best practices.

Frequently Asked Questions about qtype-architect

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

FAQPage Schema
How do I convert requirements into YAML specifications for AI pipelines?

To convert requirements into YAML specifications for AI pipelines, describe your architecture goals and the tool translates them into deployable QType declarative code for chatbots, RAG systems, and agents.

How do I validate YAML code for AI application architecture?

You validate YAML code for AI application architecture by running it against MCP-backed schemas and semantic checks, which identify structural errors and ensure the QType specification is deployable.

What is the best way to generate architecture diagrams for RAG systems and chatbots?

The best way to generate architecture diagrams for RAG systems and chatbots is to use an automated visualization tool that parses your declarative YAML orchestration code and outputs the overall structure.

Do I need an MCP server to design AI agents with declarative YAML?

Yes, you need an active qtype-mcp server to design AI agents with declarative YAML, because it provides the schema lookup, validation, and documentation access required during architecture planning.

What are the limitations of using YAML orchestration for AI applications?

Limitations of using YAML orchestration for AI applications include the strict dependency on an active MCP server for schema lookup and validation, and the need to adhere to QType's specific DSL constraints.