Skip to content

feat: add skills.sh.json grouping and validation test - #249

Merged
kevmoo merged 3 commits into
mainfrom
skills-sh-json
Oct 16, 2026
Merged

kevmoo merged 3 commits into
mainfrom
skills-sh-json

Conversation

@kevmoo

@kevmoo kevmoo commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Groups the 10 flutter-* skills (UI & Layout, Architecture & Data, Testing & Previews) on https://www.skills.sh/flutter/agent-plugins via skills.sh.json (https://www.skills.sh/docs/customize) and sets notGrouped: "bottom".

  • Demotes the 64 deleted/renamed legacy slugs (72% of the 89 rows on skills.sh) and the 15 synced dart-* copies (canonical in dart-lang/skills) into Other skills at the bottom so only the 10 flutter-* skills are featured in top-level groups.
  • Extends tool/generator/test/lint_skills_test.dart, tool/generator/README.md, and .github/workflows/skills_tool.yaml so skills.sh.json and README.md stay in sync with the flutter-* directories in skills/.

- Add `skills.sh.json` grouping the 10 Flutter skills (`UI & Layout`, `Architecture & Data`, `Testing & Previews`) and 15 synced Dart skills (`Dart Language`, `Dart Testing`, `Dart Analysis`, `Dart Interop`) while setting `notGrouped: "bottom"` to demote 64 legacy/renamed slugs on `skills.sh/flutter/agent-plugins`.
- Extend `tool/generator/test/lint_skills_test.dart` and `.github/workflows/skills_tool.yaml` to verify that `skills.sh.json` and `README.md` stay synchronized with `skills/`.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds a new skills.sh.json file defining various skill groups and introduces a validation test in lint_skills_test.dart to verify its structure and consistency. A review comment identifies a bug in the test where the assertion comparing groupedSkills to actualSkills will fail because groupedSkills contains both Dart and Flutter skills, while actualSkills only contains local Flutter skills. The reviewer suggests filtering groupedSkills to only include Flutter skills before the comparison.

Comment thread tool/generator/test/lint_skills_test.dart Outdated

@reidbaker reidbaker left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Finally if there is a best practice for what to do when renaming or deleting published skills we might want that documented someplace. Im

Comment thread .github/workflows/skills_tool.yaml Outdated
Comment thread .github/workflows/skills_tool.yaml Outdated
Comment thread skills.sh.json Outdated
Comment thread tool/generator/test/lint_skills_test.dart Outdated
Comment thread tool/generator/test/lint_skills_test.dart Outdated
Comment thread skills.sh.json Outdated
…ation

- Remove the 4 synced `Dart *` groups from `skills.sh.json` so only the 10 `flutter-*` skills are grouped at the top (`UI & Layout`, `Architecture & Data`, `Testing & Previews`) and synced `dart-*` skills fall into `notGrouped: "bottom"` alongside retired legacy slugs.
- Place `"notGrouped": "bottom"` at the end of `skills.sh.json`.
- Remove the `paths:` filter on `pull_request` and `push` in `.github/workflows/skills_tool.yaml`.
- Clarify validation steps and local string comparison (zero network calls) in `tool/generator/test/lint_skills_test.dart`.
- Document how to update `README.md` and `skills.sh.json` when adding, renaming, or deleting skills in `tool/generator/README.md`.
@kevmoo

kevmoo commented Oct 15, 2026

Copy link
Copy Markdown
Contributor Author

Added a section in tool/generator/README.md in d42bbb1 documenting what to update when adding, renaming, or deleting published skills and how skills.sh.json handles retired skill slugs.

@kevmoo
kevmoo requested a review from reidbaker October 15, 2026 17:22
@reidbaker

Copy link
Copy Markdown
Contributor

Some feedback in dart-lang/skills#54 that could also apply here for how to write better test code (or at least more human test code).

@johnpryan

Copy link
Copy Markdown
Collaborator

LGTM, is there a reason we aren't including the Dart skills also?

@kevmoo

kevmoo commented Oct 16, 2026

Copy link
Copy Markdown
Contributor Author

Applied the test readability improvements from dart-lang/skills#54 in 5bcd74d.

Re: Dart skills — per earlier review discussion (#249 (comment)), skills/dart-* are auto-synced from dart-lang/skills (grouped in dart-lang/skills#54), so we scoped groups here to flutter-* (matching README.md) to avoid breaking lint_skills_test.dart when upstream Dart skills are added or renamed.

@kevmoo
kevmoo merged commit b60d073 into main Oct 16, 2026
13 checks passed
@kevmoo
kevmoo deleted the skills-sh-json branch October 16, 2026 16:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants