Agent Matrix Skills
Canonical Matrix skill pack for supported coding agents.
Matrix ships one canonical skill pack under skills/matrix/. Runtime sync projects every skill directory with a SKILL.md into the tool-specific locations for Matrix, Claude Code, Codex, Hermes, and Agent-compatible runtimes.
Skills
| Skill | Purpose |
|---|---|
matrix-app-builder | Build Matrix apps as Vite React TypeScript projects with matrix.json and verified dist/ output. |
matrix-app-ui-patterns | Build stable app interiors for windowed, mobile, dashboard, data, and canvas contexts. |
matrix-design-system | Apply Matrix theme, shadcn-style component patterns, icon quality rules, and iframe-safe app layouts. |
matrix-integrations | Use platform-owned integrations without copying provider secrets into agents or customer VPSes. |
matrix-dev-vps | Develop Matrix from inside a user/dev VPS with hot reload, previews, and auth-aware tunnels. |
matrix-debug-app | Fix needs_build, manifest problems, bundle/icon 404s, console errors, and integration proxy issues. |
matrix-landing-design | Build public Matrix OS marketing and landing surfaces without mixing those patterns into apps. |
Sync targets
MATRIX_SKILL_TARGETS=matrix,claude,codex,hermes ./scripts/sync-matrix-agent-skills.sh skills/matrix| Consumer | Runtime path |
|---|---|
| Matrix kernel | $MATRIX_HOME/.agents/skills/<skill>/SKILL.md |
| Codex | $HOME/.agents/skills/<skill>/SKILL.md |
| Claude Code | $HOME/.claude/skills/<skill>/SKILL.md |
| Hermes | $HERMES_HOME/skills/<skill>/SKILL.md |
Agent bootstrap
matrix login
matrix run -it -- claude
matrix run -it -- codex
matrix run -it --session setup -- gh auth login
matrix shell connect -c setupUse named sessions for setup workflows so the user, Matrix web terminal, Claude, Codex, or Hermes can all reattach the same VPS context.
Codex onboarding
Matrix exposes a repo-scoped Codex plugin marketplace. From a Matrix checkout, install it with codex plugin marketplace add "$(pwd)", enable the Matrix onboarding plugin, and ask Codex to onboard the repo into Matrix OS.
Security boundary
Skills contain instructions only. They should not carry secrets, and they should prefer Matrix gateway/platform APIs for authenticated actions.
How is this guide?