Skip to content

forcedotcom/sf-skills / plugins/builder/agentforce-adlc/skills/agentforce-generate

agentforce-generate

Flagged

Build, modify, audit, repair, optimize, debug, and deploy agents with Agentforce Agent Script. TRIGGER when: user creates, reviews, or changes .agent files or aiAuthoringBundle metadata; asks to fix AgentScript, audit an existing agent, run an AgentScript health check, common-pitfall review, or baseline-versus-candidate repair loop; changes a response, action, subagent, route, state flow, or Agent Spec; migrates or upgrades a legacy GenAiPlannerBundle Agentforce agent (NOT an Einstein Bot) to an aiAuthoringBundle (Agent Script) agent; previews, debugs, deploys, publishes, or tests agents; uses sf agent generate/preview/publish/test; or manages Agentforce MCP servers, tools, assets, or authentication. DO NOT TRIGGER when: Apex, Flow, Prompt Template, Experience Cloud, or general Salesforce CLI work is unrelated to Agent Script; the source is an Einstein Bot (BotDefinition/BotVersion) — use agentforce-bot-upgrade; or the primary input is a production session or trace ID rather than an agent artifact.

FileKindSize
README.mdmarkdown5.4 KB
SKILL.mdskill md31.7 KB
assets/agent-spec-template.mdmarkdown6.4 KB
assets/agents/README.mdmarkdown2.6 KB
assets/agents/hello-world.agentother1.9 KB
assets/agents/knowledge-grounded.agentother5.6 KB
assets/agents/local-info-agent-annotated.agentother17.0 KB
assets/agents/order-service.agentother11.7 KB
assets/agents/production-faq.agentother3.9 KB
assets/agents/production-faq.bundle-meta.xmlconfig161 B
assets/agents/router-first.agentother5.6 KB
assets/agents/simple-qa.agentother1.9 KB
assets/agents/template-multi-subagent.agentother5.4 KB
assets/agents/template-single-subagent.agentother2.6 KB
assets/agents/verification-gate.agentother10.7 KB
assets/agents/voice-knowledge-grounded.agentother8.2 KB
assets/agents/voice-service-agent.agentother4.6 KB
assets/bundle-meta.xmlconfig808 B
assets/invocable-apex-template.clsother6.9 KB
assets/patterns/README.mdmarkdown10.8 KB
assets/patterns/action-callbacks.agentother4.7 KB
assets/patterns/advanced-input-bindings.agentother6.9 KB
assets/patterns/bidirectional-routing.agentother5.6 KB
assets/patterns/critical-input-collection.agentother12.2 KB
assets/patterns/delegation-routing.agentother6.4 KB
assets/patterns/lifecycle-events.agentother4.7 KB
assets/patterns/llm-controlled-actions.agentother5.1 KB
assets/patterns/multi-step-workflow.agentother10.1 KB
assets/patterns/open-gate-routing.agentother11.6 KB
assets/patterns/procedural-instructions.agentother4.8 KB
assets/patterns/prompt-template-action.agentother6.6 KB
assets/patterns/system-instruction-overrides.agentother10.6 KB
references/action-prompt-templates.mdmarkdown5.7 KB
references/actions-reference.mdmarkdown30.2 KB
references/agent-access-guide.mdmarkdown2.9 KB
references/agent-audit-and-repair.mdmarkdown7.9 KB
references/agent-audit-candidate-verification.mdmarkdown5.2 KB
references/agent-audit-diagnostic-catalog.mdmarkdown7.6 KB
references/agent-audit-diagnostics-actions-state.mdmarkdown6.9 KB
references/agent-audit-diagnostics-architecture-evaluation.mdmarkdown2.5 KB
references/agent-audit-diagnostics-instructions-routing.mdmarkdown11.8 KB
references/agent-audit-evaluation-loop.mdmarkdown6.0 KB
references/agent-audit-repair-report.mdmarkdown6.9 KB
references/agent-audit-scope-path-review.mdmarkdown8.5 KB
references/agent-design-and-spec-creation.mdmarkdown54.5 KB
references/agent-metadata-and-lifecycle.mdmarkdown30.2 KB
references/agent-script-core-language.mdmarkdown49.3 KB
references/agent-subagent-map-diagrams.mdmarkdown10.8 KB
references/agent-user-setup.mdmarkdown27.8 KB
references/agent-validation-and-debugging.mdmarkdown44.6 KB
references/agentscript-toolchain.mdmarkdown4.6 KB
references/architecture-patterns.mdmarkdown13.5 KB
references/common-control-flow-pitfalls.mdmarkdown9.4 KB
references/complex-data-types.mdmarkdown3.9 KB
references/control-flow-actions-sequencing.mdmarkdown6.9 KB
references/control-flow-lifecycle-side-effects.mdmarkdown3.3 KB
references/data-library-reference.mdmarkdown40.8 KB
references/deploy-reference.mdmarkdown6.7 KB
references/discover-reference.mdmarkdown4.3 KB
references/examples.mdmarkdown12.6 KB
references/feature-validity.mdmarkdown2.1 KB
references/instruction-resolution.mdmarkdown23.4 KB
references/known-issues.mdmarkdown27.6 KB
references/legacy-nga-regression-eval.mdmarkdown30.2 KB
references/mcp-management-reference.mdmarkdown37.6 KB
references/optimization-pattern-1-data-flow.mdmarkdown4.6 KB
references/optimization-pattern-2-deterministic-logic.mdmarkdown5.4 KB
references/optimization-pattern-3-reference-syntax.mdmarkdown4.1 KB
references/optimization-pattern-4-escalation.mdmarkdown2.2 KB
references/org-setup-for-adl.mdmarkdown23.7 KB
references/patterns-by-requirement.mdmarkdown5.4 KB
references/posture-and-determinism.mdmarkdown9.3 KB
references/production-gotchas.mdmarkdown12.6 KB
references/reference-map.mdmarkdown5.3 KB
references/safety-review-reference.mdmarkdown6.3 KB
references/salesforce-cli-for-agents.mdmarkdown16.7 KB
references/scaffold-reference.mdmarkdown6.7 KB
references/scoring-rubric.mdmarkdown3.3 KB
references/upgrade-legacy-agent-to-agentscript.mdmarkdown26.2 KB
references/version-history.mdmarkdown4.4 KB
references/voice-latency-heuristics.mdmarkdown9.7 KB
references/voice-modality-reference.mdmarkdown19.0 KB
references/voice-telephony-cli.mdmarkdown10.3 KB
references/zen-of-agentscript.mdmarkdown13.1 KB
scripts/__init__.pyscript0 B
scripts/agentscript-sdk-loader.mjsscript4.0 KB
scripts/discover.pyexecutablescript20.2 KB
scripts/generators/__init__.pyscript0 B
scripts/generators/apex_stub.pyscript13.4 KB
scripts/generators/apex_test_stub.pyscript3.8 KB
scripts/generators/flow_xml.pyscript7.6 KB
scripts/generators/permission_set_xml.pyscript1014 B
scripts/generators/remote_site_xml.pyscript1.4 KB
scripts/index-agent.mjsexecutablescript3.8 KB
scripts/org_describe.pyexecutablescript5.8 KB
scripts/scaffold.pyexecutablescript15.1 KB
scripts/setup-agentscript-sdk.mjsexecutablescript9.7 KB
scripts/upgrade-legacy-nga-analyze.pyexecutablescript20.0 KB
scripts/upgrade-legacy-nga-run-trials.shexecutablescript3.4 KB
# 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 |
| Audit and Repair | Health checks, common-pitfall review, minimal evidence-backed repairs |
| 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 |
| Migrate a Legacy Agent | `GenAiPlannerBundle` → `AiAuthoringBundle` (Agent Script) conversion, then optimize |

## Skill Structure

```text
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
│   ├── agent-audit-and-repair.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. **Use proportionate evidence** — compile local syntax changes; use preview and traces for behavior; use live actions only with approval in a safe org
3. **Use a proportionate spec gate** — require approval for greenfield and material design changes, not every one-line repair
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:

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

Restart Claude Code after installation.

The skill can install its local AgentScript compiler on first use. It uses a
skill-owned user cache and does not add dependencies to the customer's project:

```bash
node .claude/skills/agentforce-generate/scripts/setup-agentscript-sdk.mjs \
  --npm --json
```

Claude should run this automatically for every existing `.agent` file before
org-side validation. If npm setup fails, the skill can build the public
`salesforce/agentscript` source checkout. If neither provider works, the skill
continues with target-org validation or a clearly labeled static review and
states that the compiler was not used.

## Key References

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

## Version

Current version: **0.11**. See [references/version-history.md](references/version-history.md) for the full changelog.

## Credits

This skill integrates knowledge from the following sources:

**Jag Valaiyapathy** ([sf-skills](https://github.com/Jaganpro/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](https://github.com/trailheadapps/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
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall