myclaude

CLI tool to manage Claude Code skills across projects.

Instead of copy-pasting skills from one project to another, myclaude syncs them from a central git repository.

Requirements

• Python 3.12+
• Git with SSH key configured for your Gitea instance

Installation

pip install gitpython typer
pip install -e .
myclaude --install-completion  # optional: enable shell autocompletion

Central repository structure

Your Gitea repository must follow this layout:

your-repo/
├── CLAUDE.md
└── skills/
    ├── skill_name_1/
    │   └── SKILL.md
    └── skill_name_2/
        └── SKILL.md

Commands

myclaude init <project_dir>

Copies CLAUDE.md and skills from the central repo into the target project.

# First use: provide the repo URL (saved to ~/.myclaude/config.json)
myclaude init . --repo git@gitea.example.com:user/claude-skills.git

# Subsequent uses
myclaude init .

# Install specific skills only
myclaude init . --skill skill_name_1 skill_name_2

# Overwrite existing .claude/skills/
myclaude init . --force

# Keep the temporary clone for inspection (debug)
myclaude init . --keep-tmp

The project will receive:

• ./CLAUDE.md
• ./.claude/skills/<skill_name>/SKILL.md

myclaude push

Pushes local skills back to the central repository.

# Push all local skills
myclaude push

# Push specific skills only
myclaude push --skill skill_name_1 skill_name_2

# Also push CLAUDE.md
myclaude push --claude-md

myclaude status

Compares local skills with the central repository.

myclaude status

Example output:

Installed:
  [ok] skill_name_1
Local only (not pushed):
  [+]  skill_name_2
Remote only (not installed):
  [-]  skill_name_3

myclaude list

Lists all skills available in the central repository.

myclaude list

Configuration

The repo URL is stored in ~/.myclaude/config.json after the first init --repo call.

{
  "repo_url": "git@gitea.example.com:user/claude-skills.git"
}

Running tests

pytest