kris/afv-library
1
0
Fork 0
mirror of https://github.com/forcedotcom/afv-library.git synced 2026-08-05 23:41:31 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

fix: remove "What Is a Metadata Skill?" section from best_practices.md

Browse Source
This commit is contained in:
ysachdeva@salesforce.com 2026-05-05 13:12:56 +05:30
parent 01ae443d3d
commit ebf4373286
1 changed files with 0 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
skills/creating-sf-skill/references/best_practices.md
View File

@ -3,28 +3,6 @@
Principles for writing high-quality skills. Based on patterns observed across 30+
production skills in the afv-library and the Agent Skills best practices guide.
## What Is a Metadata Skill?
Agent Skills are standardized, lightweight packages that allow AI agents to load domain
expertise on demand without polluting their finite context windows. They rely on a
**Progressive Disclosure** architecture:
- **Phase 1 (Discovery)**: Only the skill's metadata (~100 tokens) is loaded into the
system prompt at startup.
- **Phase 2 (Load)**: The full SKILL.md instructions are loaded only when the user's
intent matches the skill.
- **Phase 3 (References/Scripts/Assets)**: Instructions in SKILL.md can then ask the
agent to run scripts or load references on demand.
A metadata skill is a structured SKILL.md file (with optional references and assets) that
lives in the afv-library and teaches an AI agent to generate valid Salesforce metadata XML
for a specific metadata type (CustomObject, CustomField, FlexiPage, ValidationRule, etc.).
The skill serves as the agent's domain expert — it contains the constraints, decision logic,
naming conventions, and correct/incorrect examples that prevent deployment failures.
Where skills live: `afv-library/skills/generating-{metadata-type}/`
## Core Principles
### 1. The Extraction Method