Skip to content

Commit 31e1524

Browse files
clarifying skill invocation
1 parent aa293bc commit 31e1524

1 file changed

Lines changed: 5 additions & 4 deletions

File tree

content/learning-paths/cross-platform/_example-learning-path/appendix-2-writing-style.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -200,20 +200,21 @@ Learning Paths are intended for software developers with differing experience le
200200

201201
## Use Agent Skills for AI-assisted style compliance
202202

203-
If you're creating a Learning Path with the help of an AI assistant, you can use Agent Skills to check whether your content meets these guidelines.
203+
If you're creating a Learning Path with the help of an AI assistant, you can use Agent Skills to check whether your content meets project guidelines.
204204

205205
Agent Skills are located in the project reporsitory at `.github/skills`. Skills cover Learning Path structure, writing style guidelines, as well as accessibility-related considerations such as alt-text for images.
206206

207-
Skills are invoked automatically depending on your prompts. For example, to check for style violations on a given page, you can prompt something similar to:
207+
A skill is invoked automatically depending on whether your prompt maps to the skill's `description` metadata. For example, to check for style violations on a given page, you can prompt something similar to:
208208

209209
```text
210-
Review this page for style violations.
210+
Review this page in the Learning Path for style.
211211
```
212+
By using words such as "Learning Path" and "style", the prompt invokes the `writing-style-review` skill. The AI assistant returns with a set of style-related suggestions.
212213

213214
To check whether the Learning Path is structurally sound, you can prompt something similar to:
214215

215216
```text
216217
Review this Learning Path for structure.
217218
```
218219

219-
You can explore other skills in the skills directory and tailor prompts based on the `description` metadata for AI-assisted authoring that's consistent with other Learning Paths.
220+
By using words such as "Learning Path" and "structure", the prompt invokes the `learning-path-structure-review` skill. The AI assistant returns with suggestions focused on whether each page is task oriented and the Learning Path has necessary files and sections.

0 commit comments

Comments
 (0)