sf-ai-agentforce-legacy_skill

Overview

This skill provides legacy support for creating Agentforce agents using Agent Script syntax and a 100-point validation scoring model. It is intended only for maintaining existing agents built with legacy patterns and is deprecated in favor of a newer Agent Script skill. Use it to generate, validate, and publish Agentforce authoring bundles that depend on the older conventions.

How this skill works

The skill generates complete .agent bundles and the required bundle-meta.xml, validates agent structure across six scoring categories (0–100), and guides deployment steps. It inspects agent blocks (system, config, variables, language, start_agent, topic) and checks topic design, action targets, variable linkage, instructions quality, and security guardrails. It also enforces orchestration order and delegation to Flow, Apex, and deploy skills.

When to use it

• Maintaining or updating agents already implemented with the legacy Agent Script patterns.
• Validating legacy .agent bundles before publishing to a Salesforce org running API v65.0+.
• Generating agent scaffolding consistent with older templates and templates-based repos.
• Performing the 100-point pre-deployment validation for backward-compatible agents.
• Publishing or activating legacy agents when migration to the new skill is not yet completed.

Best practices

• Verify target org API version is 65.0 or higher before creating Agent Script agents.
• Follow the mandated orchestration: metadata → apex → flow → deploy → agentforce.
• Always delegate flow creation to the Flow skill and Apex to the Apex skill; do not hand-edit Flow XML or InvocableMethod classes manually.
• Generate both the .agent and the bundle-meta.xml in the aiAuthoringBundles path and run sf agent validate before deployment.
• Use recommended templates for patterns (hello-world, simple-qa, multi-topic, action-based) to ensure consistent structure.

Example use cases

• Add a new topic and flow-based action to an existing legacy agent and re-run the 100-point validation.
• Scan and fix an agent bundle for inconsistent indentation, missing labels, or broken variable links prior to publish.
• Publish an agent authoring bundle for environments that must remain on legacy conventions while planning migration.
• Produce a validation report that scores structure, topic design, actions, variables, instructions, and security to inform remediation work.