afv-library/skills/agentforce-generate

Agentforce Development Skill

A skill for developing Agentforce agents with Agent Script.

What This Skill Covers

The skill routes agent work across the full lifecycle:

Domain	What It Handles
Create an Agent	Agent Spec design, environment checks, bundle generation, draft authoring
Modify an Agent	Subagent/action changes, instruction refinement, flow updates
Diagnose Compilation Errors	Error capture, classification, targeted fixes
Diagnose Behavioral Issues	Trace-based debugging, routing/action analysis
Deploy / Release	Draft iteration, deploy, explicit publish + activate
Test an Agent	Coverage design, spec creation, run analysis

Skill Structure

agentforce-generate/
├── SKILL.md                    # Execution router and hard rules
├── references/                 # Domain guidance and adjacent operational docs
│   ├── patterns-by-requirement.md
│   ├── posture-and-determinism.md
│   ├── agent-design-and-spec-creation.md
│   ├── architecture-patterns.md
│   ├── agent-script-core-language.md
│   ├── salesforce-cli-for-agents.md
│   ├── agent-validation-and-debugging.md
│   ├── deploy-reference.md
│   ├── agent-metadata-and-lifecycle.md
│   ├── data-library-reference.md
│   ├── ... (additional references)
├── assets/                     # Templates, examples, and reusable snippets
│   ├── agent-spec-template.md
│   ├── bundle-meta.xml
│   ├── invocable-apex-template.cls
│   ├── agents/                 # Complete agent templates (including router-first)
│   └── patterns/               # Reusable implementation patterns

How It Works

SKILL.md acts as the router. It maps user intent to task domains and required references, then enforces hard rules for safe execution.

Core rules include:

1. Always --json on every sf CLI command
2. Diagnose before you fix — preview with live actions and read traces before modifying code
3. Spec approval is a hard gate — never proceed past Agent Spec creation without user approval
4. Draft-first lifecycle — iterate in draft by default; publish/activate only with explicit user confirmation

Prerequisites

• Salesforce org with Agentforce license
• API version 66.0+ (Spring '26)
• Einstein Agent User (for service agents)
• Salesforce CLI v2.x (sf command)
• Claude Code (or compatible AI coding agent)

Installation

Copy the agentforce-generate folder into your project's .claude/skills/ directory:

your-project/
└── .claude/
    └── skills/
        └── agentforce-generate/
            ├── SKILL.md
            ├── references/
            └── assets/

Restart Claude Code after installation.

Key References

• Pattern selection: references/patterns-by-requirement.md
• Posture guidance: references/posture-and-determinism.md
• Design/spec workflow: references/agent-design-and-spec-creation.md
• Architecture mechanics: references/architecture-patterns.md
• Core language: references/agent-script-core-language.md
• Validation/debugging: references/agent-validation-and-debugging.md
• Reference index and consolidation notes: references/reference-map.md

Version

Current version: 0.6.1 (2026-05-20). See references/version-history.md for the full changelog.

Credits

This skill integrates knowledge from the following sources:

Jag Valaiyapathy (sf-skills, MIT License) — Known issues catalog, production gotchas, agent access and permissions guide, and deployment patterns. Integrated starting in v0.4.2.

Hua Xu (Salesforce APAC FDE team) — Open-gate routing pattern from Kogan agent deployment.

Salesforce DevRel (agent-script-recipes) — Canonical Agent Script examples used as grounding material.

Dylan Zeigler, AI Platform (llm-utils) — Agent Script playground used as reference source.

License

Apache-2.0