A multi-platform repository for reusable agent skills.

• Author skills once under skills-src/
• Generate platform projections for:
  • Claude Code: .claude/skills/
  • Codex: .agents/skills/
  • OpenCode: .opencode/skills/
  • WorkBuddy: .workbuddy/skills/

npm run sync                      # Sync all skills to all platforms
npm run sync:watch                # Watch mode (requires: npm install chokidar)
npm run sync:skill -- <name>      # Sync specific skill (incremental)
npm run validate                  # Validate all meta.json files
npm run test                      # Run tests

node tools/sync-skills.mjs [options]

Options:
  --skill, -s <name>    Sync only the specified skill
  --watch, -w           Watch for changes and auto-sync
  --validate, -v        Validate all meta.json files without syncing
  --help, -h            Show help message

skills-src/<skill-name>/
├── meta.json      # Required: metadata and platform configs
├── SKILL.md       # Required: skill instructions
├── scripts/       # Optional: executable scripts
├── assets/        # Optional: static resources
├── references/    # Optional: reference documents
├── prompts/       # Optional: prompt templates
└── config.json    # Optional: skill configuration

Field	Required	Description
name	✅	Lowercase kebab-case identifier (1-64 chars)
description	✅	Brief description (10-500 chars)
version	⬜	Semantic version (e.g., "1.0.0")
author	⬜	Author name or handle (max 100 chars)
tags	⬜	Array of tags for discovery (max 10 items)
entry	⬜	Path to executable script relative to skill directory
platforms	⬜	Platform-specific configurations

{
  "platforms": {
    "claude": {
      "argument_hint": "--file <path> or --text <content>",
      "allowed_tools": ["read_file", "write_to_file"],
      "user_invocable": true,
      "disable_model_invocation": false
    },
    "codex": {
      "display_name": "My Skill",
      "short_description": "A brief description",
      "allow_implicit_invocation": true
    },
    "opencode": {
      "use_claude_projection": true
    },
    "bolt": {
      "use_claude_projection": true
    }
  }
}

1. Edit a skill in skills-src/<skill-name>/
2. Run npm run sync (or npm run sync:watch for auto-sync)
3. Use the generated skill folders in your target platform

• Do not manually edit generated files under .claude/, .agents/, .opencode/, .workbuddy/
• Keep each skill focused on one task
• Prefer source edits under skills-src/
• All meta.json files are validated against skills-src/schema.json
• Incremental sync is used when syncing a specific skill (skips unchanged files)