oh-my-skills/README.md

oh-my-skills

Skills for the Pi Coding Agent.

Installation

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

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.

# 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)