oh-my-skills

oh-my-skills

Skills for the Pi Coding Agent.

Installation

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.

# npm >= 12 blocks git dependencies by default (EALLOWGIT): allow it per invocation
npm_config_allow_git=all npx git+https://gogs.gvoci.com/softword/oh-my-skills.git

# or install the command globally (persistent `agent-sync` in PATH)
npm_config_allow_git=all npm install -g git+https://gogs.gvoci.com/softword/oh-my-skills.git

# 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

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

On cmd.exe run set npm_config_allow_git=all first; on PowerShell use $env:npm_config_allow_git='all'. To pick up new commits, reinstall with the same npm install -g command: the content is embedded in the package, so tool and content update together.

⚠️ The repository is private: Git access to gogs.gvoci.com must be configured (saved credentials or SSH key), otherwise the install 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
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)