oh-my-skills/README.md

oh-my-skills

Skills for the Pi Coding Agent.

Installation with npx skills

The skills CLI clones the repo, automatically detects pi, and installs the skills you choose.

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

Useful variants:

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

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.

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