Skip to main content

Skills

Kalami installs 5 dev flow skills that handle common workflows with verification built in. You don't need to remember commands — just tell Claude what you want.

Commit​

Triggers: "commit", "save this"

What it does:

  1. Runs the verify chain (typecheck, lint, test)
  2. Reviews staged changes for issues
  3. Stages only the files you specify
  4. Generates a conventional commit message
feat(auth): add OAuth2 login flow

The committer blocks .env, .git/, and node_modules/ from being staged. It warns when you mix source and test files in one commit, stage too many files (>5), or change too many lines (>300).

Push​

Triggers: "push it", "push this"

What it does:

  1. Runs the full verify chain
  2. Pushes to remote
  3. Creates a PR if you're on a feature branch

If tests fail, the push is blocked. Fix the issue and try again.

Release​

Triggers: "release", "publish"

What it does:

  1. Determines version bump (patch/minor/major)
  2. Bumps version in your manifest (package.json, pyproject.toml, Cargo.toml)
  3. Updates CHANGELOG.md from git log
  4. Commits, tags, and pushes
  5. CI handles the actual publish

Key rule: version is bumped before writing the changelog, so the changelog entry has the correct version number.

Review​

Triggers: "review this", "check my code"

What it does:

  1. Gets the diff of current changes
  2. Reviews for: type errors, error handling, security, performance, style, missing tests, magic numbers
  3. Reports by severity:
    • Critical — must fix before committing
    • Warning — should fix
    • Suggestion — nice to have

Plan​

Triggers: "plan", "think first", "build", "implement"

See Planning Workflow for the full flow.

How skills work​

Skills are markdown files in .claude/skills/kalami-*/SKILL.md. They contain:

  • Trigger phrases
  • Step-by-step instructions
  • Verification commands (auto-filled from your project detection)

Claude reads the skill when triggered and follows the instructions. The skill itself contains no AI logic — it's a template with your project's specific commands injected.

Customizing skills​

Skills are generated during install with your project's detected commands. If your verify commands change, reinstall to update:

npx kalami --force

You can also edit the skill files directly in .claude/skills/ — they won't be overwritten on normal reinstall (only on --force).