Skip to content

Marve10s/Better-skills

Repository files navigation

better-skills

JSR

Bidirectional converter between .agents/skills/ (industry standard) and .claude/skills/ (Claude Code format).

Quick Start

Run this command in your project directory (where your .agents/skills/ or .claude/skills/ folder is):

deno run -A jsr:@marve10s/better-skills

That's it. No installation, no cloning. The interactive wizard guides you through the conversion.

Alternative: Install globally

deno install -A -g -n better-skills jsr:@marve10s/better-skills

# Then use anywhere:
better-skills

The Problem

  • Industry standard: .agents/skills/ is used by Cursor, OpenCode, Copilot, Codex, and 40+ other AI tools
  • Claude Code: Uses .claude/skills/ with the same SKILL.md format
  • The gap: Claude Code doesn't look in .agents/skills/

This tool bridges the gap with one command.

Examples

# Interactive mode - auto-detects and prompts for options
deno run -A jsr:@marve10s/better-skills

# Convert .agents/skills → .claude/skills (for Claude Code)
deno run -A jsr:@marve10s/better-skills --to-claude

# Convert .claude/skills → .agents/skills (export to other tools)
deno run -A jsr:@marve10s/better-skills --to-agents

# Sync both directions
deno run -A jsr:@marve10s/better-skills --sync

# Non-interactive with all options
deno run -A jsr:@marve10s/better-skills --to-claude --mode symlink --conflict skip --non-interactive

Options

Option Description
--to-claude Convert .agents/skills/.claude/skills/
--to-agents Convert .claude/skills/.agents/skills/
--sync Bidirectional sync
--mode <mode> symlink (default), copy, or move
--conflict <mode> skip (default), overwrite, or backup
--non-interactive Skip prompts, use defaults
--source <dir> Custom source directory
--target <dir> Custom target directory
--help Show help

Conversion Modes

Mode Description
symlink Creates links - changes sync automatically (recommended)
copy Duplicates files - changes must be synced manually
move Moves files - removes from source

Requirements

License

MIT

About

I'm tired of reading how should I handle MCPs and Skills for every agent so here's the script to not read all these stuff

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors