Metadata-Version: 2.4
Name: morpheus-skills
Version: 0.1.1
Summary: Install Codex/Claude style SKILL.md packages to local agent skill directories.
Author: Contributors
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# morpheus-skills

Reusable AI agent skills stored as directory-based packages (each containing a `SKILL.md`).

## Recommended Package Manager

Use `uv` for package management and distribution.

- It is cross-platform (macOS/Linux/Windows), unlike Homebrew.
- It supports both project-local and global CLI installs.
- It works well for Python-based installer tooling and CI automation.

Use Homebrew only as an optional distribution channel for macOS users after the Python package is stable.

Repository/package branding: `morpheus-skills`  
Installer CLI command: `morpheus`

## Install as a Package

### With `uv` (recommended)

Install from this repo:

```bash
uv tool install .
morpheus list
morpheus install --agent codex --all
```

Run without installing globally:

```bash
uv run morpheus list
uv run morpheus install --agent claude --all --dry-run
```

### With `pipx`

```bash
pipx install .
morpheus install --agent codex --all
```

### Use repo skills instead of bundled package skills

The packaged CLI ships with bundled skills. To install directly from a local checkout, pass `--source`:

```bash
morpheus install --agent codex --all --source .
```

## CLI Usage

Install all bundled skills to Codex user scope:

```bash
morpheus install --agent codex --all
```

Install one skill to Claude project scope:

```bash
morpheus install --agent claude --scope repo --skill product-minded-dev
```

Install to a custom agent directory:

```bash
morpheus install --agent custom --target ~/.my-agent/skills --all
```

## Supported Defaults

- Codex user scope: `$CODEX_HOME/skills` or `~/.codex/skills`
- Codex repo scope: `.codex/skills`
- Claude user scope: `~/.claude/skills`
- Claude repo scope: `.claude/skills`

For additional TUIs/agents, use `custom` with `--target`/`-Target`.

## Contributing

See [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution, quality, and PR guidelines.

## Release to PyPI (GitHub Actions)

This repository includes `.github/workflows/publish.yml`.

1. Bump version in `pyproject.toml` and `morpheus/__init__.py`.
2. Commit and push to `main`.
3. Create and push a version tag (for example `v0.1.1`).

```bash
git tag v0.1.1
git push origin v0.1.1
```

The workflow builds `dist/*` and publishes to PyPI using trusted publishing.

One-time PyPI setup:

- In PyPI project settings for `morpheus-skills`, add a trusted publisher:
- Owner: your GitHub user/org
- Repository: `rybkr/morpheus`
- Workflow name: `publish.yml`
- Environment: `pypi`
