skills/skill-sync/SKILL.md
Syncs skill metadata to AGENTS.md Auto-invoke sections across the NX monorepo. Trigger: When creating or modifying a skill, updating metadata.scope/metadata.auto_invoke, or regenerating Auto-invoke tables.
npx skillsauth add johnnystefan/test-saas-business skill-syncInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Keeps all AGENTS.md files in sync with skill metadata. When you create or modify a skill, run the sync script to automatically update the Auto-invoke tables in every affected AGENTS.md.
Each skill that should appear in Auto-invoke sections needs these fields in frontmatter:
metadata:
author: gentleman-programming
version: "1.0"
scope: [root] # Which AGENTS.md files to update
auto_invoke: "Creating Zod schemas or validators" # Single action
# OR multiple actions:
# auto_invoke:
# - "Creating Zod schemas or validators"
# - "Validating request DTOs"
| Scope | Updates |
|-------|---------|
| root | AGENTS.md (repo root) |
| admin | apps/admin/AGENTS.md |
| customer | apps/customer/AGENTS.md |
| api-gateway | apps/api-gateway/AGENTS.md |
| auth-service | apps/auth-service/AGENTS.md |
| club-service | apps/club-service/AGENTS.md |
| inventory-service | apps/inventory-service/AGENTS.md |
| booking-service | apps/booking-service/AGENTS.md |
| finance-service | apps/finance-service/AGENTS.md |
| libs | libs/AGENTS.md |
Skills can target multiple scopes: scope: [root, admin, customer]
# Sync all AGENTS.md files
./skills/skill-sync/assets/sync.sh
# Dry run — preview changes without writing
./skills/skill-sync/assets/sync.sh --dry-run
# Sync only one scope
./skills/skill-sync/assets/sync.sh --scope admin
./skills/skill-sync/assets/sync.sh --scope root
skills/*/SKILL.md filesmetadata.scope and metadata.auto_invoke from each### Auto-invoke Skills section in each target AGENTS.mdGiven this skill:
# skills/zod/SKILL.md
metadata:
author: gentleman-programming
version: "1.0"
scope: [root, api-gateway, auth-service]
auto_invoke:
- "Creating Zod schemas or validators"
- "Validating request DTOs"
The sync script adds to AGENTS.md, apps/api-gateway/AGENTS.md, and apps/auth-service/AGENTS.md:
### Auto-invoke Skills
| Action | Skill |
|--------|-------|
| Creating Zod schemas or validators | `zod` |
| Validating request DTOs | `zod` |
metadata.scope to new/modified skillmetadata.auto_invoke with clear action description./skills/skill-sync/assets/sync.shtools
Zustand 5 state management patterns. Trigger: When implementing client-side state with Zustand (stores, selectors, persist middleware, slices).
databases
Zod 4 schema validation patterns. Trigger: When creating or updating Zod v4 schemas for validation/parsing (forms, request payloads, adapters), including v3 -> v4 migration patterns.
development
Vitest unit testing patterns with React Testing Library. Trigger: When writing unit tests for React components, hooks, or utilities.
tools
Vite 8 (Rolldown-powered) build tool configuration, plugin API, SSR, and migration guide. Trigger: When working with vite.config.ts, Vite plugins, building libraries, or SSR apps with Vite.