Developer Handbook

Workflow Skills

Skills that automate workflow tasks—PR creation, commit messages, and code review

Workflow Skills

Skills are packaged instructions that teach a coding agent our conventions. Invoking one by name loads its instructions for the rest of the task, so the agent follows our workflow instead of improvising one.

Available Skills

Create Pull Request (/unio-create-pr)

Guides you through creating a properly structured draft PR following our workflow. It:

  • Creates your branch with correct naming
  • Makes an empty initial commit
  • Pushes to GitHub and creates a draft PR
  • Links tracking cards automatically
  • Fills out the PR template

Use this when starting new work to ensure everything is set up correctly from the beginning.

Suggest Commit Message (/unio-commit)

Analyzes your changes and suggests a properly formatted Conventional Commit message. It:

  • Determines the correct type (feat, fix, docs, etc.)
  • Writes a clear, concise summary
  • Adds body text when context is needed
  • Follows imperative mood and formatting rules

Use this when you're unsure how to phrase a commit message or want to ensure it follows our conventions.

Code Review (/unio-code-review)

Conducts a structured code review following our standards. It:

  • Analyzes code for security, performance, and quality
  • Checks against feature specs and plans
  • Verifies test patterns and coverage
  • Provides educational feedback
  • Creates a structured review document
  • Optionally posts to GitHub

Use this for self-review before marking your PR ready, or when reviewing someone else's code.

Ship (/ship)

Runs the full pre-merge pipeline and opens the PR.

The full set also covers planning, specs, QA, deployment, and release.

How to Use Skills

Type / followed by the skill name (for example /unio-create-pr) and press Enter. The agent guides you through the process interactively.

There is nothing to attach. Each skill picks up the state it needs on its own — /unio-commit reads your staged changes, /unio-code-review reads the branch diff.

Skill files

Skill definitions live in .claude/skills/, one directory per skill with a SKILL.md holding its instructions. Add a directory there to add a skill.

Backend- and frontend-specific skills live in backend/.claude/skills/ and frontend/.claude/skills/. They load only when work is happening in that part of the tree.