# oh-my-skills

Skills for the [Pi Coding Agent](https://www.npmjs.com/package/@earendil-works/pi-coding-agent).

## Installation with `npx skills`

The [skills](https://github.com/vercel-labs/skills) CLI clones the repo, automatically detects pi,
and installs the skills you choose.

```bash
npx skills add https://gogs.gvoci.com/softword/oh-my-skills.git
```

Useful variants:

```bash
# List available skills without installing anything
npx skills add https://gogs.gvoci.com/softword/oh-my-skills.git -l

# Install only some skills
npx skills add https://gogs.gvoci.com/softword/oh-my-skills.git -s commit -s coding-standard-rules

# Install globally (all projects) instead of the current project
npx skills add https://gogs.gvoci.com/softword/oh-my-skills.git -g

# Install ALL skills without confirmations
npx skills add https://gogs.gvoci.com/softword/oh-my-skills.git --all

# Copy files instead of creating symlinks
npx skills add https://gogs.gvoci.com/softword/oh-my-skills.git --copy
```

> ⚠️ The repository is private: Git access to `gogs.gvoci.com` must be configured
> (saved credentials or SSH key), otherwise the clone fails.

Updates and removal:

```bash
npx skills update        # update installed skills (project)
npx skills update -g     # update only globally installed skills
npx skills remove        # remove skills (guided)
npx skills remove -g     # remove globally installed skills
npx skills ls            # list installed skills
```

## Install everything with `agent-sync`

`agent-sync` copies the skills and the agent prompts into the canonical `~/.agents/`
directory and links them into every AI agent detected on the machine
(Claude Code, pi, Codex, OpenCode, Cursor, Gemini, Trae, Windsurf, Aider Desk).
On Windows it uses junctions for skill directories and degrades gracefully
(hardlink, then copy) for agent files; on macOS/Linux it uses relative symlinks.

```bash
# one-shot, nothing persisted
npx git+https://gogs.gvoci.com/softword/oh-my-skills.git

# or install the command globally
npm install -g git+https://gogs.gvoci.com/softword/oh-my-skills.git
agent-sync

# dry-run: report drift without writing anything (exit 1 when out of sync)
agent-sync --check
```

## Skill catalog

| Skill | What it is for |
|---|---|
| `add-phpengine-plugin` | Create or modify PHP plugins for the phpengine backend, following the official recipe |
| `ascii-preview-generator` | ASCII visual previews of interfaces, layouts, and UI components |
| `codebase-analysis` | Analyze and document the architecture of an existing codebase without modifying it |
| `code-simplifier` | Simplify and refactor code while preserving its behavior |
| `coding-standard-rules` | Code quality rules applied to every write/edit task |
| `commit` | Atomic Conventional Commits-style commits + CHANGELOG updates |
| `create-docs` | Generate structured project documentation (AGENTS.md, specs/) |
| `format-report-fix` | Standard format for reporting fixes with concrete impact |
| `frontend-mobile-rules` | Mobile-first frontend rules: MUI, viewport, and iOS safe-area |
| `brainstorming` | Orchestrator: brainstorming, inspection, planning, delegation, and review |
| `refactor-rename` | Safe renaming of identifiers across files and folders (script included, with dry-run) |
| `review-fix-loop` | Repeated review→fix loop until zero violations |
| `session-handoff` | Writes a HANDOFF.md to hand the work off to another agent or session |
| `spec-design-format` | Mandatory format for design specs in `.spec/` |
| `ssh-manager` | Remote server inspection via the ssh-manager MCP plugin (health, logs, DB, processes) |