Skip to content

Commit af71432

Browse files
skills nits
1 parent d6fec68 commit af71432

3 files changed

Lines changed: 7 additions & 5 deletions

File tree

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Use this skill when a Learning Path needs a structural review. Focus on whether
1010
## Workflow
1111

1212
1. Identify the Learning Path directory and read the relevant Markdown files together.
13-
2. State the owned developer task in one sentence. If the task is unclear, too broad, or split across unrelated goals, flag it.
13+
2. Summarize the developer task owned by LP in one sentence. If the task is unclear, too broad, or split across unrelated goals, flag it.
1414
3. Check the required file shape:
1515
- The Learning Path has an `_index.md` file.
1616
- The Learning Path has an `_next-steps.md` file.

.github/skills/seo-geo-aeo-review/SKILL.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,9 +23,11 @@ For focused front matter `description` edits only, use `.github/skills/metadata-
2323

2424
## Workflow
2525

26+
On any given page:
27+
2628
1. Identify the target content type and target developer intent.
27-
2. Read the title, front matter description, headings, introduction, prerequisites, main task flow, validation, conclusion, and further reading. If you've previously read a page, use context and don't re-read it unless there's a change since the last read.
28-
3. State the page's owned task in one sentence. If the task is unclear or too broad, flag it.
29+
2. Read the title, front matter description, headings, introduction, prerequisites, main task flow, validation, conclusion, and further reading. If you've previously read the page, use context and don't re-read it unless asked to.
30+
3. Summarize the page's owned task in one sentence. If the task is unclear or too broad, flag it.
2931
4. Review SEO signals:
3032
- The title is task-led and includes the main technology, platform, or tool.
3133
- The `description` is one concise sentence that states the task, context, and outcome.

.github/skills/writing-style-review/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,10 @@ Use this skill for granular prose, voice, readability, terminology, and style re
1010
## Workflow
1111

1212
1. Identify the target file, section, or selected text.
13-
2. Read surrounding context so style edits preserve the author's intent and the technical flow. If you've previously read the page, use context and don't re-read it unless there's a change since the last read.
13+
2. Read surrounding context so style edits preserve the author's intent and the technical flow. If you've previously read the page, use context and don't re-read it unless asked to.
1414
3. Review the target against the guidelines defined in this skill.
1515
4. Depending on request type, do the following:
16-
- For review requests, report high-impact style issues by file and line when possible.
16+
- For review requests, report style issues by file and line when possible, ordered by severity.
1717
- For edit requests, make focused rewrites, then re-open changed sections to check Markdown, shortcodes, links, and code fences.
1818

1919
## Voice and tone

0 commit comments

Comments
 (0)