> ## Documentation Index
> Fetch the complete documentation index at: https://developer.watson-orchestrate.ibm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bob skills

## Overview

The Bob skill set supports the complete lifecycle of building enterprise AI agent solutions:

1. **solution-architect:** Transforms business problems into structured solution architectures with executive summaries, technical designs, and implementation roadmaps. Provides the foundation for SOP development.
2. **sop-builder:** Converts technical procedures and workflows (for example, BPMN, Langflow, n8n) into business-readable Standard Operating Procedures with plain-language descriptions, Mermaid diagrams, and detailed process documentation.
3. **wxo-builder:** Implements production-ready watsonx Orchestrate solutions from SOPs or prompts, generating agents, tools, flows, and knowledge bases following ADK best practices and project structures.
4. **wxo-analyzer:** Reverse-engineers existing watsonx Orchestrate projects to produce comprehensive documentation, relationship diagrams, and anti-pattern analysis across enterprise AI failure modes for auditing and onboarding.
5. **agent-instructions-evaluator:** Zooms into a specific agent to assess instruction quality and production viability. Evaluates operational achievability, not writing quality, by identifying runtime reliability risks such as hidden state, conflicting rules, vague scope, and brittle phrasing. Produces per-dimension scores and evidence-backed findings across five evaluation dimensions.

Together, these skills form a closed-loop system for designing, building, documenting, and maintaining enterprise-grade watsonx Orchestrate solutions.

## Available skills

### 1. solution-architect

**Location:** [solution-architect/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/solution-architect/SKILL.md)

The solution-architect skill turns business problems into clear, structured solution architectures. It bridges business and technical perspectives by producing:

* Executive-level solution overviews
* Technical architecture and design patterns
* Implementation roadmaps and SOP-ready documentation

**Best for:** Early-stage design and stakeholder alignment

**Key capabilities:**

* Analyzing business requirements and problem statements
* Generating three focused architecture documents: Solution Overview, Technical Architecture, and Implementation Plan
* Producing business-focused summaries and context
* Bridging business needs with technical implementation
* Preparing documentation for elaboration into detailed SOPs
* Producing modular, manageable documentation

### 2. sop-builder

**Location:** [sop-builder/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/sop-builder/SKILL.md)

The sop-builder skill transforms technical workflows into business-readable Standard Operating Procedures. It:

* Converts BPMN, Langflow, and n8n workflows into plain-language procedures
* Documents decision points, exceptions, integrations, and prompts
* Produces Mermaid diagrams and business-ready process descriptions

**Best for:** Standardizing and operationalizing processes

**Key capabilities:**

* Analyzing BPMN diagrams, Langflow JSON, and n8n workflows
* Generating business-focused SOPs in plain language
* Producing business process flow diagrams with Mermaid
* Documenting data requirements and custom logic
* Documenting LLM prompts
* Defining business procedure steps and decision points
* Documenting exception handling and integration points
* Translating technical concepts into business language

### 3. wxo-builder

**Location:** [wxo-builder/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/wxo-builder/SKILL.md)

The wxo-builder skill turns SOPs or prompts into fully implemented watsonx Orchestrate solutions. It:

* Generates agents, tools, flows, and knowledge bases
* Follows recommended ADK project structures and patterns
* Supports multiple knowledge base backends and end-to-end CLI workflows

**Best for:** Implementing production-ready watsonx Orchestrate builds

**Key capabilities:**

* Generating complete watsonx Orchestrate implementations from Standard Operating Procedures (SOPs)
* Transforming business requirements into agents, tools, flows, and knowledge bases
* Recommended workflow: use sop-builder to create SOPs from BPMN, n8n, or Langflow first, then use wxo-builder to generate watsonx Orchestrate solutions
* Knowledge base providers: Milvus, AstraDB, Elasticsearch
* Standard project structure and implementation patterns
* Document processing flows and workflow patterns
* Python tool and flow decorators
* Agent YAML configuration
* CLI import commands and best practices
* Complete examples from the ADK repository

### 4. wxo-analyzer

**Location:** [wxo-analyzer/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/wxo-analyzer/SKILL.md)

The wxo-analyzer skill reverse-engineers and documents existing watsonx Orchestrate projects. It:

* Analyzes project structure and components
* Produces multi-report documentation sets (overview, agents, tools)
* Generates diagrams and relationship mappings
* Detects anti-patterns and provides recommendations

**Best for:** Understanding, auditing, or onboarding into existing watsonx Orchestrate solutions

**Key capabilities:**

* Analyzing existing watsonx Orchestrate project structures
* Generating three-report documentation sets: Solution Overview, Agent Analysis, and Tools & Components
* Creating Mermaid diagrams that show component relationships
* Documenting agents, tools, connections, and knowledge bases
* Producing project structure and component inventories
* Mapping relationships between agents, tools, and resources
* Detecting anti-patterns across 15 enterprise AI failure modes
* Counting instruction lines and analyzing complexity
* Assessing production readiness

### 5. agent-instructions-evaluator

**Location:** [agent-instructions-evaluator/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/agent-instructions-evaluator/SKILL.md)

The agent-instructions-evaluator skill zooms into a specific agent to evaluate its instructions for operational achievability in production settings. It focuses on instruction quality and production viability rather than writing quality, identifying runtime reliability risks and execution failures before they reach production. It:

* Focuses on a single agent's instructions to assess runtime reliability and instruction quality
* Identifies issues that stem from hidden state, conflicting rules, vague scope, and brittle phrasing
* Produces structured evaluation reports with evidence-backed findings
* Provides per-dimension scores across five evaluation dimensions (0–5 scale)

**Best for:** Zooming into a specific agent to validate instruction quality and production viability before deployment

**Key capabilities:**

* Evaluating agent instructions across five dimensions: Task Understanding, Scope and Applicability, Execution and Tool Grounding, Instruction Followability, and State and Conflict Manageability
* Counting deterministic signals (exact phrases, nested branches, implicit state)
* Producing evidence-backed findings with impact analysis and recommendations
* Prioritizing risks and identifying high-leverage improvements
* Generating structured JSON output for evaluation harnesses
* Supporting watsonx Orchestrate YAML, system prompts, and agent definitions
* Assessing production readiness with a focus on runtime reliability

## How the skills work together

A typical end-to-end workflow:

```wrap theme={null}
Business problem
      ↓
[solution-architect] → Solution architecture documents
      ↓
[sop-builder] → Standard Operating Procedures
      ↓
[wxo-builder] → watsonx Orchestrate implementation
      ↓
[wxo-analyzer] → Documentation and anti-pattern analysis
      ↓
[agent-instructions-evaluator] → Per-agent instruction quality assessment
```

In this closed-loop system:

1. **solution-architect** establishes the foundation and high-level design.
2. **sop-builder** produces detailed, business-readable procedures.
3. **wxo-builder** implements the technical solution.
4. **wxo-analyzer** validates, documents, and identifies improvements at the solution level.
5. **agent-instructions-evaluator** provides a review of a specific agent's instructions by focusing on a single agent to evaluate the quality, clarity, effectiveness, and overall viability of its instructions.

## Using these skills

### In Claude Desktop or web

1. Navigate to the Skills section in Claude.
2. Import the desired skill by selecting the appropriate SKILL.md file:
   * [solution-architect/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/solution-architect/SKILL.md) for solution architecture documentation
   * [sop-builder/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/sop-builder/SKILL.md) for SOP generation from workflows
   * [wxo-builder/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/wxo-builder/SKILL.md) for watsonx Orchestrate development
   * [wxo-analyzer/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/wxo-analyzer/SKILL.md) for analyzing existing watsonx Orchestrate projects
   * [agent-instructions-evaluator/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/agent-instructions-evaluator/SKILL.md) for evaluating agent instructions
3. The skill is available in your conversations.

## Agent skills overview

Agent skills provide a standardized way to give AI agents new capabilities and domain expertise.

### What are agent skills?

Agent skills are a lightweight, open format for extending AI agent capabilities with specialized knowledge and workflows.

At its core, a skill is a folder that contains a SKILL.md file. This file includes metadata (at minimum, a name and description) and instructions that tell an agent how to perform a specific task. Skills can also bundle scripts, reference materials, templates, and other resources.

```
my-skill/
├── SKILL.md          # Required: metadata + instructions
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
├── assets/           # Optional: templates, resources
└── ...               # Any additional files or directories
```

### Why use agent skills?

Agents are increasingly capable, but often lack the context required to do real work reliably. Skills address this by packaging procedural knowledge and organization-specific context into portable, version-controlled folders that agents load on demand. Skills provide agents with:

* **Domain expertise:** Specialized knowledge, including legal review processes, data analysis pipelines, and presentation formatting, packaged as reusable instructions and resources.
* **Repeatable workflows:** Multi-step tasks expressed as consistent, auditable procedures.
* **Cross-product reuse:** Skills built once and used across any skills-compatible agent.

### How agent skills work

Agents load skills through progressive disclosure in three stages:

1. **Discovery:** At startup, agents load only the name and description of each available skill, which is enough to identify when a skill is relevant.
2. **Activation:** When a task matches a skill's description, the agent reads the full SKILL.md instructions into context.
3. **Execution:** The agent follows the instructions, running bundled code or loading referenced files as needed.

## Skill structure

Each skill follows the skills format:

* **SKILL.md:** Main skill file with frontmatter (name, description)
* **examples.md:** Complete reference implementations and code examples (where applicable)
* **Frontmatter:** Skill metadata
* **Content:** Expert guidance, specifications, and best practices

## Resources

* [solution-architect/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/solution-architect/SKILL.md)

* [sop-builder/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/sop-builder/SKILL.md)

* [wxo-builder/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/wxo-builder/SKILL.md)

* [wxo-analyzer/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/wxo-analyzer/SKILL.md)

* [agent-instructions-evaluator/SKILL.md](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/agent-instructions-evaluator/SKILL.md)

* [Reference examples](https://github.com/IBM/ibm-watsonx-orchestrate-adk/blob/main/skills/customercare-mcp-builder/references/examples.md)