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

assets/agents/router-first.agent

View on GitHub
# Router-First Architecture Template
#
# Use a central router when distinct request types need different objectives,
# instructions, actions, authority, or escalation behavior. Do not persist
# ordinary user inputs merely to keep a request handler focused; each action
# uses slot filling from the current turn and surviving conversation history.

system:
    messages:
        welcome: "Welcome! I can help with orders, returns, or general support."
        error: "I apologize, something went wrong. Let me try again."
    instructions: |
        You are a customer service agent for an e-commerce company. During
        request classification, choose exactly one matching request handler
        without answering the underlying request. In order and return handlers,
        use the available read actions for external facts. In general support,
        answer the question or transfer to a human when needed.

access:
    default_agent_user: "agent@yourorg.com"

config:
    developer_name: "Router_First_Agent"
    agent_label: "Customer Service Agent"
    description: "Routes orders, returns, and support requests to distinct handlers"

language:
    default_locale: "en_US"

start_agent agent_router:
    label: "Request Router"
    description: "Routes the user's latest request without answering it"

    model_config:
        model: "model://sfdc_ai__DefaultEinsteinHyperClassifier"

    reasoning:
        instructions: ->
            | Route only the user's latest request. Choose exactly one route,
              and do not answer the underlying request in this router.
        actions:
            check_order: @utils.transition to @subagent.orders
                description: "Handle order status or tracking"
            handle_return: @utils.transition to @subagent.returns
                description: "Handle return eligibility or an existing return"
            general_help: @utils.transition to @subagent.support
                description: "Handle a general support question"

subagent orders:
    label: "Order Help"
    description: "Handles order status and tracking inquiries"

    actions:
        get_order_status:
            description: "Look up the current status of a specific order rather than answer a general shipping-policy question"
            inputs:
                order_id: string
                    description: "Order number supplied by the customer"
                    is_required: True
            outputs:
                status: string
                    description: "Current order status"
            target: "flow://Get_Order_Status"

    reasoning:
        instructions: ->
            | Help with the user's latest order status or tracking request. Ask
              for an order number only when it is absent from the current turn
              and surviving conversation history. Report only action-returned
              status as an external fact.
            | If the user changes intent, use the matching transition.
        actions:
            lookup_order: @actions.get_order_status
                description: "Look up a concrete order using the latest order number in the conversation"
                with order_id=...
            to_returns: @utils.transition to @subagent.returns
                description: "Handle a changed request about returns"
            reclassify: @utils.transition to @subagent.agent_router
                description: "Reclassify any other changed intent"

subagent returns:
    label: "Return Help"
    description: "Explains return eligibility and looks up existing return status"

    actions:
        get_return_status:
            description: "Look up an already-created return; this does not create a return or issue money"
            inputs:
                return_id: string
                    description: "Existing return identifier supplied by the customer"
                    is_required: True
            outputs:
                status: string
                    description: "Current return status"
            target: "flow://Get_Return_Status"

    reasoning:
        instructions: ->
            | Explain return eligibility and policy, or look up an existing
              return when the user provides a return identifier. This template
              intentionally does not create returns or issue refunds; those
              consequential actions require machine-checkable authorization,
              exact targets, confirmation, idempotency, and failure handling.
            | If the user changes intent, return to request routing.
        actions:
            lookup_return: @actions.get_return_status
                description: "Look up an existing return using the latest return identifier in the conversation"
                with return_id=...
            reclassify: @utils.transition to @subagent.agent_router
                description: "Reclassify a changed intent"

subagent support:
    label: "General Support"
    description: "Handles general support questions that need no order or return action"

    reasoning:
        instructions: ->
            | Answer the user's latest general support question. If the request
              requires order or return handling, route to the matching handler.
        actions:
            go_orders: @utils.transition to @subagent.orders
                description: "Handle a changed request about an order"
            go_returns: @utils.transition to @subagent.returns
                description: "Handle a changed request about a return"
            escalate: @utils.escalate
                description: "Transfer to a human when the user explicitly requests one or the issue cannot be handled safely"
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