Skip to content

Commit befaa1e

Browse files
more clarification and minor skill tweak
1 parent 7f6d544 commit befaa1e

2 files changed

Lines changed: 3 additions & 3 deletions

File tree

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,11 @@ Use this skill when a Learning Path needs a structural review. Focus on whether
1717
- Additional resources and next steps live in `_index.md` `further_reading`, not in `_next-steps.md`.
1818
- `_next-steps.md` remains minimal and respects `FIXED, DO NOT MODIFY` template comments.
1919
4. Review the instructional shape:
20-
- The title and opening frame one developer task.
20+
- The title and opening frame one developer task/job-to-be-done.
2121
- The introduction gives context, user goal, and practical value.
2222
- Prerequisites are explicit and linked when useful.
2323
- Learning objectives are measurable, action-oriented, and limited to three or four bullets.
24-
- Sections progress logically through prepare, configure, use, and validate phases.
24+
- Sections progress logically through prepare, configure, use, and validate phases, with each section ideally focusing on one job-to-be-done.
2525
- Validation steps prove the learner reached the promised outcome.
2626
- The conclusion or next-step guidance names what the learner can do next.
2727
5. Review `further_reading`:

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -217,4 +217,4 @@ To check whether the Learning Path is structurally sound, you can prompt somethi
217217
Review this Learning Path for structure.
218218
```
219219

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 whether the Learning Path has necessary files and sections.
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 such as whether the Learning Path is task-oriented and has necessary files and sections.

0 commit comments

Comments
 (0)