Merge pull request #3459 from anupras-mohapatra-arm/fixes

Adding a short blurb to contributor LP about using skills for style compliance + tweaking a skill

Author: pareenaverma

.github/skills/learning-path-structure-review/SKILL.md

@@ -17,11 +17,11 @@ Use this skill when a Learning Path needs a structural review. Focus on whether
    - Additional resources and next steps live in `_index.md` `further_reading`, not in `_next-steps.md`.
    - `_next-steps.md` remains minimal and respects `FIXED, DO NOT MODIFY` template comments.
 4. Review the instructional shape:
-   - The title and opening frame one developer task.
+   - The title and opening of the Learning Path frame one developer task/job-to-be-done. 
    - The introduction gives context, user goal, and practical value.
    - Prerequisites are explicit and linked when useful.
    - Learning objectives are measurable, action-oriented, and limited to three or four bullets.
-   - Sections progress logically through prepare, configure, use, and validate phases.
+   - Sections progress logically through prepare, configure, use, and validate phases, with each section ideally focusing on one job-to-be-done. Flag nebulous sections with titles such as "working with x" or "managing y" that include multiple tasks that shouldn't be grouped together (e.g. creating and deleting a VM, or creating a VM and security group rules in the same section). 
    - Validation steps prove the learner reached the promised outcome.
    - The conclusion or next-step guidance names what the learner can do next.
 5. Review `further_reading`:

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

@@ -193,12 +193,28 @@ Learning Paths are intended for software developers with differing experience le
 
 | Software Development Areas                 | Skills |
 |-------------------------------------       |----------|
-| 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) |
+| 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> |
 | 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> | 
 | Mobile				     | <ul> <li> Experience with software development on mobile platforms such as Android. </li> <li> Experience with mobile development and testing frameworks. </li> </ul> |
 | 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> |
 
+## Use Agent Skills for AI-assisted style compliance
 
+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. 
 
+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. 
 
+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:
 
+```text
+Review this page in the Learning Path for style. 
+```
+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.
+
+To check whether the Learning Path is structurally sound, you can prompt something similar to:
+
+```text
+Review this Learning Path for structure. 
+```
+
+By using words such as "Learning Path" and "structure", the prompt invokes the `learning-path-structure-review` skill. The AI assistant returns with suggestions such as whether the Learning Path is task-oriented and has necessary files and sections.