333-333-333/skill-sync
skills/skill-sync/SKILL.md
Syncs skill metadata to AGENTS.md Auto-invoke sections. Trigger: After creating/modifying skills, regenerating Auto-invoke tables, or troubleshooting missing skills in AGENTS.md.
data-ai
Updated Mar 25, 2026
$ install --global
skillsauthnpx skillsauth add 333-333-333/agents skill-syncInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Error
VirusTotalMulti-engine malware detection
70%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 25, 2026, 12:31 PM43.0s3 files scanned
SKILL.md
- name:
- skill-sync
- description:
- >
- Trigger:
- After creating/modifying skills, regenerating Auto-invoke tables, or troubleshooting missing skills in AGENTS.md.
- license:
- Apache-2.0
- author:
- template
- version:
- 1.0
- type:
- meta
- scope:
- [root]
- allowed-tools:
- Read, Edit, Write, Glob, Grep, Bash
Purpose
Keeps AGENTS.md Auto-invoke sections in sync with skill metadata. When you create or modify a skill, run the sync script to automatically update all affected AGENTS.md files.
Required Skill Metadata
Each skill that should appear in Auto-invoke sections needs these fields in metadata:
metadata:
author: your-name
version: "1.0"
type: generic # generic | project | meta
scope: [root] # Which AGENTS.md files to update
auto_invoke: "When to invoke this skill" # Single action or list
The type field classifies skills: generic (reusable across projects), project (specific to this project), or meta (skills that manage the skills system itself). Meta skills are excluded from sync — they are managed manually in the Meta-Skills section.
Scope Values
Scopes are discovered dynamically based on your project structure:
| Scope | Updates |
|-------|---------|
| root | ./AGENTS.md (repository root) |
| <directory> | ./<directory>/AGENTS.md |
Examples:
scope: [root]updates./AGENTS.mdscope: [frontend]updates./frontend/AGENTS.mdscope: [root, backend, frontend]updates all three
Skills can target multiple scopes: scope: [root, api, ui]
Auto-invoke Format
Single action:
auto_invoke: "Creating new components"
Multiple actions:
auto_invoke:
- "Creating new components"
- "Refactoring component structure"
Usage
After Creating/Modifying a Skill
./skills/skill-sync/assets/sync.sh
What It Does
- Reads all
skills/*/SKILL.mdfiles - Extracts
metadata.scopeandmetadata.auto_invoke - Generates Auto-invoke tables for each scope
- Updates the
### Auto-invoke Skillssection in each AGENTS.md
Commands
# Sync all AGENTS.md files
./skills/skill-sync/assets/sync.sh
# Dry run (show what would change)
./skills/skill-sync/assets/sync.sh --dry-run
# Sync specific scope only
./skills/skill-sync/assets/sync.sh --scope frontend
# Run tests
./skills/skill-sync/assets/sync_test.sh
Example
Given this skill metadata:
# skills/my-skill/SKILL.md
metadata:
author: dev
version: "1.0"
scope: [frontend]
auto_invoke: "Creating React components"
The sync script generates in frontend/AGENTS.md:
### Auto-invoke Skills
When performing these actions, ALWAYS invoke the corresponding skill FIRST:
| Action | Skill |
|--------|-------|
| Creating React components | `my-skill` |
Troubleshooting
Skill not appearing in AGENTS.md
- Check
metadata.scopeexists and is valid - Check
metadata.auto_invokeexists - Verify the target AGENTS.md file exists (e.g.,
./frontend/AGENTS.md) - Run with
--dry-runto see what would be generated
Warning: No AGENTS.md found for scope
The scope references a directory that doesn't have an AGENTS.md file. Either:
- Create the AGENTS.md file in that directory
- Remove the scope from the skill's metadata
Checklist After Modifying Skills
- [ ] Added
metadata.scopeto new/modified skill - [ ] Added
metadata.auto_invokewith action description - [ ] Ran
./skills/skill-sync/assets/sync.sh - [ ] Verified AGENTS.md files updated correctly
Related Skills
333-333-333/ux-review
testing
VerifiedTrustedCommunity
Review Flutter components and screens for UX/UI compliance. Trigger: When user invokes /ux-review command or requests UX audit.
SKILL.mdUpdated Mar 25, 2026
333-333-333/typescript
development
VerifiedTrustedCommunity
TypeScript strict patterns and best practices. Trigger: When implementing or refactoring TypeScript in .ts/.tsx (types, interfaces, generics, const maps, type guards, removing any, tightening unknown).
SKILL.mdUpdated Mar 25, 2026
333-333-333/testing-strategy
testing
VerifiedTrustedCommunity
Testing philosophy and strategy for every feature: test pyramid, mandatory levels per change type, completion checklist, and skill delegation. Trigger: When planning tests for a feature, reviewing test coverage, defining acceptance criteria, or asking what tests a change needs.
SKILL.mdUpdated Mar 25, 2026
333-333-333/terraform-security
development
VerifiedTrustedCommunity
Terraform security practices: sensitive variables, secret management, state protection, .gitignore patterns, and CI/CD credential handling. Trigger: When handling secrets in Terraform, configuring state backends, reviewing .gitignore for Terraform, or setting up CI/CD pipelines for infrastructure.
SKILL.mdUpdated Mar 25, 2026