agentforce-architecture-analyze

Analyze Agentforce metadata to produce an architecture snapshot and invocation graph.

Updated Jun 17, 2026
One-click install
npx skills add https://github.com/angryracoon/ARIEF-VISEO-DEV-ORG --skill agentforce-architecture-analyze
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agentforce-architecture-analyze
Source: https://github.com/angryracoon/ARIEF-VISEO-DEV-ORG/tree/main/.agents/skills/agentforce-architecture-analyze
Command: npx skills add https://github.com/angryracoon/ARIEF-VISEO-DEV-ORG --skill agentforce-architecture-analyze

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill turns opaque Agentforce agent metadata into a clear, shareable architecture snapshot so teams can understand how an agent is wired without manually tracing Salesforce records.

Core Features & Use Cases

  • Declared Architecture Snapshot: Resolves the planner, topics, actions, flows, Apex classes, prompt templates, and NGA plugins for a specific agent.
  • Visual Documentation: Produces a human-readable architecture document and Mermaid invocation graph for review, audits, and change tracking.
  • Use Case: Use it when you need to compare two agent versions, inventory an agent’s tools, or document the action tree for a Salesforce org before release.

Quick Start

Ask the skill to document the architecture of a specific Agentforce agent in a specific org.

Frequently Asked Questions about agentforce-architecture-analyze

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

FAQPage Schema
How do I document Agentforce architecture and generate an invocation graph for a Salesforce org?

To document Agentforce architecture, the skill analyzes BotDefinition, BotVersion, GenAi tooling objects, flow, Apex, and prompt template metadata to produce a shareable architecture snapshot and Mermaid invocation graph. It resolves the planner, topics, actions, and NGA plugins for a specific agent.

What is the best way to compare two Agentforce agent versions across Salesforce orgs?

The best way to compare Agentforce agent versions is by running an architecture snapshot and version diff. The skill audits the action tree and topic inventory, resolving metadata changes across Salesforce orgs to highlight structural differences visually.

Can I inventory Apex classes and flows wired to a specific Agentforce agent?

Yes, you can inventory an Agentforce agent's tools by retrieving flow and Apex class bodies along with prompt template metadata. The skill maps all declared actions, topics, and NGA plugins to give a complete tool inventory for design-time reviews.

Does Agentforce metadata analysis require specific tooling objects to run successfully?

Agentforce metadata analysis requires BotDefinition, BotVersion, GenAi tooling objects, flow and Apex body retrieval, and prompt template metadata. The skill also implements caching and redaction-safe error handling to manage these dependencies securely during processing.

Why does my Agentforce architecture audit fail when retrieving GenAi tooling objects?

An Agentforce architecture audit may fail if required GenAi tooling objects, BotDefinition, or BotVersion records are missing or inaccessible. The skill applies redaction-safe error handling and caching to mitigate retrieval issues, but valid metadata must exist in the Salesforce org.