StreamFlow Git Workflow

SkillCommunication

This skill should be used when the user asks to "write a commit message", "create a commit", "format a commit", "what commit type to use", or when preparing changes for a git commit in StreamFlow. Provides commit message format, type conventions, and examples.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the StreamFlow Git Workflow skill

What this skill tells your AI

The instructions your AI receives, as published by alpha-unito/streamflow in .agents/skills/git/SKILL.md and read by ahel’s review.

Commit message conventions and CHANGELOG update rules for StreamFlow. The approval rule (never commit without explicit user approval) lives in AGENTS.md.

Commit Message Format

<Type> <subject>

<body>

Types

TypeWhen to use
AddWholly new feature or file
FixBug fix
RefactorCode change with no behavior change
UpdateEnhancement to an existing feature
RemoveDeletion of code or files
BumpDependency version update
ImplementNew implementation of an existing interface
ImprovePerformance or quality improvement
DocsDocumentation only
TestTest additions or changes

Rules

Subject line:

  • Start with a type word (imperative mood), capitalized, no trailing period
  • Max 50 characters
  • Example: Add restore method to DataManager

Body (required except for trivial changes like typo fixes):

  • Blank line separating subject from body
  • Explain what and why, not how
  • Wrap at 72 characters
  • Use backticks around package names, rule/error codes, file names, and Python identifiers (functions, classes, variables, methods)
  • Reference issues: Fixes #123, Closes #456

CHANGELOG

Before every commit, CHANGELOG.md must be updated under ## [Unreleased]. Load the StreamFlow Changelog Update skill for the full rules on which subsection to use, entry format, and what to avoid.

Examples

Add restore method to DataManager

Implement restore method to enable workflow recovery from checkpoints.
This allows jobs to resume from the last completed step.
Fix SSH connector authentication timeout (Fixes #931)

Increase default timeout for SSH authentication from 5s to 30s to handle
slow networks and high-latency connections.
Bump kubernetes-asyncio from 33.3.0 to 34.3.3
Refactor DirectedGraph class

Extract graph traversal logic into dedicated methods to reduce coupling
and improve testability of scheduling algorithms.

Signals

GitHub stars
65
Forks
19
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
streamflow-git-workflow
Source
github.com/alpha-unito/streamflow