Skip to content

Commit 6b53f63

Browse files
committed
feat: prefix skills with vgv- to improve discoverability
1 parent 98b03a1 commit 6b53f63

11 files changed

Lines changed: 23 additions & 23 deletions

File tree

CLAUDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ skills/
3737

3838
Every `SKILL.md` follows this structure:
3939

40-
1. **YAML frontmatter**`name` (lowercase letters, numbers, and hyphens only) and `description` fields
40+
1. **YAML frontmatter**`name` (prefixed with `vgv-`, lowercase letters, numbers, and hyphens only, e.g., `vgv-bloc`) and `description` fields
4141
2. **H1 title** — human-readable skill name
4242
3. **Core Standards** — enforced constraints, always first
4343
4. **Content sections** — architecture, code examples, workflows, anti-patterns

README.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -51,14 +51,14 @@ For example:
5151
You can also invoke skills directly as slash commands:
5252

5353
```bash
54-
/accessibility
55-
/bloc
56-
/internationalization
57-
/layered-architecture
58-
/material-theming
59-
/navigation
60-
/static-security
61-
/testing
54+
/vgv-accessibility
55+
/vgv-bloc
56+
/vgv-internationalization
57+
/vgv-layered-architecture
58+
/vgv-material-theming
59+
/vgv-navigation
60+
/vgv-static-security
61+
/vgv-testing
6262
```
6363

6464
## What Each Skill Provides

scripts/validate_skills.sh

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
#!/bin/bash
22
# Validates that every skills/*/SKILL.md follows the required structure:
33
# 1. YAML frontmatter delimiters (opening and closing ---)
4-
# 2. name field present and matching ^[a-z0-9-]+$
5-
# 3. name matches the parent directory name
4+
# 2. name field present and matching ^vgv-[a-z0-9-]+$
5+
# 3. name equals "vgv-" + parent directory name
66
# 4. description field present and non-empty
77
# 5. H1 heading after frontmatter
88
# 6. "## Core Standards" section exists
@@ -42,15 +42,15 @@ while IFS= read -r file; do
4242
else
4343
# --- Check 4: name format ---
4444
name_value=$(echo "$name_line" | sed 's/^name:[[:space:]]*//')
45-
if [[ ! "$name_value" =~ ^[a-z0-9-]+$ ]]; then
46-
echo "::error file=$file::Invalid name '$name_value' — must match ^[a-z0-9-]+$"
45+
if [[ ! "$name_value" =~ ^vgv-[a-z0-9-]+$ ]]; then
46+
echo "::error file=$file::Invalid name '$name_value' — must match ^vgv-[a-z0-9-]+$"
4747
errors=$((errors + 1))
4848
file_errors=$((file_errors + 1))
4949
fi
5050

5151
# --- Check 5: name matches directory ---
52-
if [[ "$name_value" != "$dir_name" ]]; then
53-
echo "::error file=$file::Frontmatter name '$name_value' does not match directory name '$dir_name'"
52+
if [[ "$name_value" != "vgv-$dir_name" ]]; then
53+
echo "::error file=$file::Frontmatter name '$name_value' does not match expected 'vgv-$dir_name'"
5454
errors=$((errors + 1))
5555
file_errors=$((file_errors + 1))
5656
fi

skills/accessibility/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
name: accessibility
2+
name: vgv-accessibility
33
description: Flutter accessibility auditing and remediation with WCAG 2.1 level selection (A, AA, AAA) across mobile, desktop, and web platforms. Use when building, auditing, or reviewing widgets for screen reader support, touch targets, focus management, color contrast, text scaling, or motion sensitivity. Begins by asking the WCAG conformance level and target platform(s) before applying level-appropriate, platform-aware criteria.
44
---
55

skills/bloc/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
name: bloc
2+
name: vgv-bloc
33
description: Best practices for Bloc state management in Flutter/Dart. Use when writing, modifying, or reviewing code that uses package:bloc, package:flutter_bloc, or package:bloc_test.
44
---
55

skills/internationalization/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
name: internationalization
2+
name: vgv-internationalization
33
description: Best practices for internationalization (i18n) and localization (l10n) in Flutter. Use when adding, modifying, or reviewing ARB translations, locale setup, BuildContext l10n extensions, or RTL/directional layout support.
44
---
55

skills/layered-architecture/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
name: layered-architecture
2+
name: vgv-layered-architecture
33
description: Best practices for VGV layered monorepo architecture in Flutter. Use when structuring a multi-package Flutter app, creating data or repository packages, defining layer boundaries, or wiring dependencies between packages.
44
---
55

skills/material-theming/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
name: material-theming
2+
name: vgv-material-theming
33
description: Best practices for Flutter theming using Material 3. Use when creating, modifying, or reviewing ThemeData, ColorScheme, TextTheme, component themes, spacing systems, or light/dark mode support.
44
---
55

skills/navigation/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
name: navigation
2+
name: vgv-navigation
33
description: Best practices for navigation and routing in Flutter using GoRouter. Use when creating, modifying, or reviewing routes, deep links, redirects, or navigation logic that uses package:go_router or package:go_router_builder.
44
---
55

skills/static-security/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
name: static-security
2+
name: vgv-static-security
33
description: >
44
Best practices for Flutter mobile app security. Use when reviewing or writing
55
code that handles secrets, user data, network communication, authentication,

0 commit comments

Comments
 (0)