Engineering Handbook

Skills

How to use Skills to make work consistent and repeatable

Skills are reusable, structured playbooks for common tasks. They reduce repeated prompt-writing and make outcomes more consistent across the team.

When to use

  • You repeat the same kind of tasks (docs creation, config updates, repo conventions)
  • You want consistent outputs and guardrails (security, style, verification)
  • You want to reduce mistakes in multi-step work

When not to use

  • The task is one-off and small
  • The skill would require embedding sensitive context (don’t do that)

Useful guide

  • Ensure skills include constraints and verification steps.
  • Keep skills repo-agnostic when possible.
  • Update skills when conventions change.

On this page