forcedotcom/sf-skills/agentforce-architecture-analyze
Claude Code and agent skill by forcedotcom/sf-skills
- community
Checking that the SKILL.md file is still in the repository.
Declared architecture snapshot for one Agentforce agent: planner, topics, actions, flows, Apex, prompt templates, and NGA plugins. Renders a human-readable architecture document and Mermaid invocation graph from design-time metadata (not runtime audit rows). TRIGGER when user asks to describe, diagram, inventory, audit, document, or diff (e.g. v3 vs v5) the architecture / action tree / topic structure / tool inventory of a specific agent by agent API name in a specific org. DO NOT TRIGGER for runtime session traces, conversation transcripts, generation timings, or gateway audit chains — this skill reads design-time metadata only (use agentforce-d360-analyze for session traces).
Install
npx vskill@latest install forcedotcom/sf-skills/agentforce-architecture-analyzeSKILL.md
The same SKILL.md was published earlier as forcedotcom/sf-skills/agentforce-architecture-analyze.
agentforce-architecture-analyze — declared architecture snapshot
Design-time metadata tree for one Agentforce agent: planner → topics → actions → flows → Apex → prompts → NGA plugins. Reads declared metadata only — BotDefinition, GenAiPlanner*, GenAiPlugin*, GenAiFunction*, Flow, ApexClass, GenAiPromptTemplate. Does not read runtime audit rows.
Runtime budget: 30–45s typical, ≤60s hard cap on reference fixtures. Sequential baseline would be 90–220s; parallel Tooling SOQL fan-out delivers a 3–5× speedup. Large bots with many flows scale approximately linearly — each flow metadata retrieve is one round-trip.
Runs inline — no subagent. Every phase is deterministic file processing.
If the user hasn't named an agent
Trigger condition: $ARGUMENTS names no agent (no --agent flag and no exact BotDefinition API name in the prose). Never invent an agent name. Instead, discover what the org actually contains — one read-only query, no pipeline yet. Use the --org alias if given, otherwise the default target org (omit --target-org):
If the user gave no org alias, the pipeline block defaults --org to the CLI default target org itself (sf config get target-org --json → .result[0].value) — you don't need to resolve it.
Then branch on the rows returned:
- Zero agents — tell the user the org has no Agentforce agents and stop. Do not fabricate an agent or a tree.
- Exactly one agent, or exactly one whose `DeveloperName`/`MasterLabel` matches the user's description (e.g. "support", "service", "sales") — use it, say explicitly which agent you picked and why, then run the pipeline block below with
ARG_AGENT=<DeveloperName>(andARG_ORG=<alias>if the user named one) set as its first lines, e.g.ARG_AGENT=Customer_Support_Agent. The block readsARG_*from the environment; flags in$ARGUMENTSstill override. - Otherwise — print the block below, with the discovered agents listed as a numbered
DeveloperName — MasterLabeltable under the first line, and wait for the user to pick. - Query fails (no default org, auth error) — print the block below without the list.
Which agent should I document, and in which org?I need:- Agent API name — theDeveloperNameof theBotDefinition(e.g.MyAgent,MySalesAgent). Not the label.- Org alias — forsfCLI auth (the alias you configured withsf org login)Optional:- Version — anagent_version_api_namelikev5. If omitted, I'll resolve the activeBotVersion.- `--force` — ignore cached tree; re-fetch everything.- `--reprobe` — re-run the 7-day channel-probe cache (only needed after a Salesforce release).I'll run the metadata pipeline inline. Artifacts land under~/.vibe/data/agentforce-architecture-analyze/<org_id15>/<agent_api_name>__<agent_version>/(overridable with--data-dir).
Pipeline invocation
Run this block once the agent is known — from --agent <api_name> in $ARGUMENTS, or preset as ARG_AGENT=<DeveloperName> after discovery. --org (or ARG_ORG) is optional; without it the CLI default target org is used. One python3 invocation drives the full pipeline. main.py writes .emit_ctx.json; emit_result.py reads it and prints the final === RESULT === block last to stdout.
Inputs
| Input | Flag | Required | Default | |
|---|---|---|---|---|
org_alias | --org | no | sf CLI default target org (sf config get target-org) | |
agent_api_name | --agent | yes | — | |
agent_version_api_name | --version | no | active BotVersion | |
force_refresh | --force | no | false (honor cache) | |
reprobe | --reprobe | no | false (honor 7-day channel-probe cache) | |
parallelism | --parallelism | no | 5 | |
max_mermaid_nodes | --max-mermaid-nodes | no | 80 | |
data_dir | --data-dir | no | ~/.vibe/data/agentforce-architecture-analyze | |
cache_dir | --cache-dir | no | ~/.vibe/cache/agentforce-architecture-analyze |
Outputs
All artifacts under ~/.vibe/data/agentforce-architecture-analyze/<org_id15>/<agent_api_name>__<agent_version>/ (default; override with --data-dir <path>):
Pipeline — inline, no subagent
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassedPattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/agentforce-architecture-analyze/SKILL.md
Popularity
- Repository stars
- 1,054
- Repository forks
- 353
- 7-day trend score
- 35
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/forcedotcom/sf-skills/agentforce-architecture-analyze)