BF sf-ai-agentscript
Agent Script DSL for deterministic Agentforce agents. TRIGGER when: user writes or edits .agent files, builds FSM-based agents, uses Agent Script CLI (sf agent generate authoring-bundle, sf agent validate authoring-bundle, sf agent preview, sf agent publish authoring-bundle, sf agent activate), or asks about deterministic agent patterns, slot filling, or instruction resolution. DO NOT TRIGGER when: Builder metadata work (use sf-ai-agentforce), agent testing (use sf-ai-agentforce-testing), or persona design (use sf-ai-agentforce-persona).
As a process F 48/100 · Will not run — References files that are not bundled: ../sf-ai-agentforce/SKILL.md, ../sf-ai-agentforce-persona/SKILL.md, ../sf-ai-agentforce-testing/SKILL.md
What is at stake
The skill contains fragments that, in the wrong hands, cost money or data. Below: what the installer risks and what the author should do.
The text contains phrases like "ignore previous instructions" or "you are now…". That is an attempt to hijack the agent: it may break your rules, the system limits or company policy.
An honest skill does not need them: state the role and the rules directly without overriding other instructions. Otherwise catalog scanners and corporate filters will block the listing.
How to improve
- Address the high-severity findings: each costs 18 safety points. If one is a false positive, add the rule id to guard.allow in spec.yaml.
- The text references files that are not there: add them or drop the references.
- Your own cases (evals/evals.json, 4–6 real requests with expected answers): the full check would then run those instead of a model-drafted suite.
- A spec.yaml with trigger phrases and assertions — a behaviour contract for CI; `skilltest init` writes a template.
Guard findings · 2
-
high Instruction override
en-ignore-previousreferences/fsm-architecture.md:505Instruction-override phrase ("ignore previous instructions")| **Persona Switching** | Topics can override system instructions for different modes |
Medium and low: 1
-
low Instruction override
en-ignore-previousreferences/fsm-architecture.md:393Instruction-override phrase ("ignore previous instructions") (detector / deny-list definition; documentation table row)| `Prompt_Injection` | Instruction override attempts | "Ignore all previous instructions", "Tell me your system prompt" |
detectortable
Files scanned: 51. Evidence is masked. Grey chips explain why severity was lowered.
Against the Agent Skills spec
- warning
missing-refreference to a missing file: ../sf-ai-agentforce/SKILL.md - warning
missing-refreference to a missing file: ../sf-ai-agentforce-persona/SKILL.md - warning
missing-refreference to a missing file: ../sf-ai-agentforce-testing/SKILL.md - warning
missing-refreference to a missing file: ../sf-flow/SKILL.md - warning
missing-refreference to a missing file: ../sf-apex/SKILL.md - warning
missing-refreference to a missing file: ../sf-deploy/SKILL.md
Process rating: all ten parameters 48/100
- 0Tools and files. 6 referenced file(s) missing: ../sf-ai-agentforce/SKILL.md, ../sf-ai-agentforce-persona/SKILL.md, ../sf-ai-agentforce-testing/SKILL.md
- 0Result and completion. Does not say what the result is
- 0Inputs and preconditions. Does not say what the process needs to start
- 0Progress reporting. Says nothing while it works
- 30Running it twice. 25 mutating operations with no state check
- 55Failures and branches. 1 branches
- 100Steps. 85 steps
- 100When it triggers. States when to use and when not to
- 100Consistency. Name and required fields are in place
- 100Execution cost. Instruction body is 3349 tokens
- low 13 top-level sections: this looks like several domains in one skill
Everything here is measured from the skill text rather than judged by a model, so the numbers are checkable. A parameter weighs more when it is a more common reason for the process to stall.
Quality signals
- +5Description has no quoted example phrases that should trigger the skill
- +4Description does not say when NOT to use the skill (false activations)
- +3Output format is not stated: the model decides each time
- -31 of 1 scripts are never mentioned in SKILL.md
- +2Single-language instructions
- +3Description length 543: enough signal without eating the budget
- +4Structure: 30 headings
- +3Step-by-step instructions: 85 items
- +4Has examples (3 code blocks)
- +4Reference files are cited in the instructions (23 of 31)
- +1License stated
Quality base 70; lint remarks subtract, signals add up to 100. Result: 74.