afv-library/skills/creating-sf-skill/templates/skill_template.md

name	description	license	metadata	allowed-tools
<SKILL_NAME>	<PRIMARY_PURPOSE>. TRIGGER when: <users mention METADATA_TYPE_NAMES, FILE_EXTENSIONS, or ask to ACTION_VERBS — include 5+ specific trigger phrases and implicit contexts where the user may not use the exact domain term>. SKIP when: <EXCLUSION_TRIGGERS with delegation targets>. Always use this skill for any <DOMAIN> metadata work.	LICENSE.txt has complete terms	version stage author last_updated compatibility 1.0 Draft <team-name> <YYYY-MM-DD> <REQUIRED_TOOLS_AND_ENVIRONMENT>	<list only the tools the skill needs, e.g. Bash(sf project deploy start) Read Write>

<1-3 sentence overview: what this skill does and why it exists.>

Scope

• In scope:
• Out of scope: <what this skill does NOT handle — delegate to other skills>

---

Clarifying Questions

Before generating, confirm with the user if not already clear:

• <Question 1 — most critical information needed>
• <Question 2 — type or subtype selection>
• <Question 3 — constraint-affecting detail>
• <Question 4 — relationship or dependency info>

---

Required Inputs

Gather or infer before proceeding:

• <Input 1>:
• <Input 2>:
• <Input 3>:

Defaults unless specified:

• <Default 1>
• <Default 2>

If the user provides a clear, complete request, generate immediately without unnecessary back-and-forth.

---

Workflow

All steps are sequential. Do not skip or reorder. If blocked, stop and ask for missing context.

2. Read the template — load assets/<template-file> before generating.

3. • For , read references/<topic>.md.

4. • Compare output against examples/<example-file>.

---

Rules / Constraints

Constraint	Rationale
<Rule 1>
<Rule 2>

---

Gotchas

Issue	Resolution
<Problem 1>
<Problem 2>

---

Output Expectations

Deliverables:

• <File 1>: <path pattern>
• <File 2>: <path pattern>

File structure follows the template in assets/<template-file>.

---

Cross-Skill Integration

Need	Delegate to
<Need 1>	<other-skill> skill
<Need 2>	<other-skill> skill

---

Reference File Index

File	When to read
assets/<template-file>	Before generating — use as the starting structure
references/<topic>.md	When handling
examples/<example-file>	To verify generated output matches expected format