Skip to content

Commit 01e29f6

Browse files
adding section for skill usage to writing style page
1 parent b0f291d commit 01e29f6

1 file changed

Lines changed: 16 additions & 1 deletion

File tree

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

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -193,12 +193,27 @@ Learning Paths are intended for software developers with differing experience le
193193

194194
| Software Development Areas | Skills |
195195
|------------------------------------- |----------|
196-
| Embedded and Microcontroller | Understanding of programming languages such as C, C++ and assembly. Basic awareness of Linux OS, RTOSes. Fundamental knowledge of hardware and software architecture (not necessarily Arm) |
196+
| Embedded and Microcontroller | <ul><li>Understanding of programming languages such as C, C++ and assembly.</li> <li>Basic awareness of Linux OS, RTOSes.</li> <li>Fundamental knowledge of hardware and software architecture (not necessarily Arm)</li></ul> |
197197
| Server and Cloud | <ul><li> Understanding of web services and Linux.</li><li> Basic awareness of containerization and orchestration technologies such as Docker and Kubernetes.</li><li> Proficient in programming languages such as Python and Java.</li></ul> |
198198
| Mobile | <ul> <li> Experience with software development on mobile platforms such as Android. </li> <li> Experience with mobile development and testing frameworks. </li> </ul> |
199199
| Desktop and Laptop | <ul> <li> Experience with operating systems such as Windows and macOS. </li> <li> Experience with common development frameworks such as .NET and Electron. </li> Proficient in programming languages such as C++, Java and Python. </li> </ul> |
200200

201+
## Use Agent Skills for AI-assisted style compliance
201202

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.
202204

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

207+
Skills are invoked automatically depending on your prompts. For example, to check for style violations on a given page, you can prompt:
204208

209+
```text
210+
Review this page for style violations.
211+
```
212+
213+
To check whether the Learning Path is structurally sound, you can prompt:
214+
215+
```text
216+
Review this Learning Path for structure.
217+
```
218+
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.

0 commit comments

Comments
 (0)