Matrix Skills

The canonical Matrix skill pack that coding agents use to build, debug, and extend Matrix OS.

Matrix ships a canonical skill pack under skills/matrix/. Each skill is a Markdown file with frontmatter that coding agents (Claude Code, Codex, Hermes) discover and load automatically. Skills tell agents how Matrix works — build conventions, UI patterns, debug playbooks, and integration rules — without embedding secrets or duplicating docs.

Skill pack

matrix-app-builder

Build Matrix apps as Vite React TypeScript projects with matrix.json manifests, Postgres-backed app data, and production build verification.

matrix-app-ui-patterns

UI patterns for windowed, mobile, dashboard, data, and canvas contexts. Use this when building the interior of an app.

matrix-design-system

The Matrix visual language: colors, typography, icons, animations, and component patterns. Apply when building or polishing any Matrix surface.

matrix-integrations

Use platform-owned integrations from apps or agents without exposing provider secrets.

matrix-dev-vps

Develop Matrix OS itself with hot reload and live previews.

matrix-debug-app

Fix needs_build responses, missing dist bundles, broken manifests, icon 404s, console errors, and integration proxy issues.

matrix-landing-design

Build public Matrix OS marketing and landing surfaces without mixing those patterns into app code.

Where agents find skills

Skills are synced into the discovery paths for each supported agent:

Agent	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`

Sync the skill pack

From a Matrix OS checkout, run:

MATRIX_SKILL_TARGETS=matrix,claude,codex,hermes ./scripts/sync-matrix-agent-skills.sh skills/matrix

This writes each skill into all four discovery paths. Re-run after pulling skill updates.

Skills are instructions, not secrets

Matrix skills do not contain Pipedream, Clerk, Gmail, GitHub, Slack, or any provider credentials. Authenticated actions go through Matrix's own platform APIs.