diff --git a/workshop/29-skills-and-domain-knowledge.md b/workshop/29-skills-and-domain-knowledge.md index 92fc5c63..85b07c54 100644 --- a/workshop/29-skills-and-domain-knowledge.md +++ b/workshop/29-skills-and-domain-knowledge.md @@ -101,6 +101,12 @@ Once a skill exists, decide how your workflow prompt should point to it. There a - **Fusion** — reference only the exact skill fragment the agent needs with a `` comment. Best when the task is narrow and well-defined and you want to keep the prompt compact. - **Inline** — embed the skill fragment directly in the workflow file under a `## skill: \`name\`` heading. Best when the skill is small and specific to a single workflow. + + + + Diagram showing a SKILL.md file feeding three injection strategies -- hint, fusion, and inline -- each flowing into the workflow prompt the agent reads. + + > :bulb: **Optional Side Quest:** For the full decision table, code examples for each strategy, and a hands-on practice exercise, see [Skill Injection Strategies — Hint, Fusion, and Inline](side-quest-29-01-skill-injection-strategies.md). ### Wire the skill into a workflow and validate diff --git a/workshop/images/29-skill-injection-strategies-dark.svg b/workshop/images/29-skill-injection-strategies-dark.svg new file mode 100644 index 00000000..51c9d65c --- /dev/null +++ b/workshop/images/29-skill-injection-strategies-dark.svg @@ -0,0 +1,44 @@ + + +Choosing a skill injection strategy +One SKILL.md, three ways to reach the workflow prompt + + + +SKILL.md +Domain convention, +written once + +Hint +Agent discovers skills +Broad sets, big budget + +Fusion +Reference exact fragment +Narrow, well-defined task + +Inline +Embed fragment directly +Small, single workflow + + + + +Workflow prompt +Agent reads and +applies the skill + + + + + + + + +1 + +2 + +3 +Write the convention once, then pick hint, fusion, or inline based on scope and context budget. + \ No newline at end of file diff --git a/workshop/images/29-skill-injection-strategies-light.svg b/workshop/images/29-skill-injection-strategies-light.svg new file mode 100644 index 00000000..3f2ac2a1 --- /dev/null +++ b/workshop/images/29-skill-injection-strategies-light.svg @@ -0,0 +1,44 @@ + + +Choosing a skill injection strategy +One SKILL.md, three ways to reach the workflow prompt + + + +SKILL.md +Domain convention, +written once + +Hint +Agent discovers skills +Broad sets, big budget + +Fusion +Reference exact fragment +Narrow, well-defined task + +Inline +Embed fragment directly +Small, single workflow + + + + +Workflow prompt +Agent reads and +applies the skill + + + + + + + + +1 + +2 + +3 +Write the convention once, then pick hint, fusion, or inline based on scope and context budget. + \ No newline at end of file