# oh-my-skills

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

## Installation

Clone the repository and run the tool from its own folder — no npm/npx.

```bash
git clone https://gogs.gvoci.com/softword/oh-my-skills.git
cd oh-my-skills

# sync everything into every detected agent
node bin/agent-sync.mjs --all
# equivalent: npm run sync -- --all

# pick up new content: pull and re-run
git pull && node bin/agent-sync.mjs --all
```

`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; for agent files it creates
a symlink, or a hardlink when symlinks are unavailable (it never copies: if no
link mechanism works the sync aborts with an error); on macOS/Linux it uses
relative symlinks. Selection is explicit: only what a flag lists is synced,
a selection flag without a value covers its whole dimension, and without any
selection flag `agent-sync` prints its help.
`--sys` never takes a value (unlike `--skills`/`--agents`/`--targets`): passing
one is rejected with a usage error; combine it with `--targets` to restrict
destinations. The `--sys` flag (also covered by `--all`) additionally copies the
repository-level `SYSTEM_PROMPT.md` into each detected agent's config folder as
its global system prompt — copies only, never linked and never placed in
`~/.agents/` — renamed to the agent's standard filename: `CLAUDE.md` for
Claude Code, `APPEND_SYSTEM.md` for pi, `AGENTS.md` for Codex and OpenCode
(`~/.config/opencode`), `memories/global_rules.md` for Windsurf
(`~/.codeium/windsurf`, always on, max 6,000 characters); Cursor (user rules
live only in its settings), Trae and Aider Desk have no standard file and are
skipped. `--check` reports drift for these files too.

```bash
# discover what is bundled and which agents are detected on the machine
agent-sync --list

# sync everything into every detected agent
agent-sync --all

# sync only some skills, only into some agents
agent-sync --skills commit,coding-standard-rules --targets claude,pi

# a flag without a value covers the whole dimension: every skill into pi
agent-sync --skills --targets pi

# sync only agent prompts (canonical copy, links, pi manifests)
agent-sync --agents gv-dev,gv-reviewer

# sync only the system prompt into some agents
agent-sync --sys --targets claude,pi

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

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

## 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 |
| `brainstorming` | Orchestrator: brainstorming, inspection, planning, delegation, and review |
| `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 |
| `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 |
| `ssh-manager` | Remote server inspection via the ssh-manager MCP plugin (health, logs, DB, processes) |