mael

github:sminnee/maelstrom · first committed 2026-01-15 · source · badge

REQUIRED for git/GitHub operations: Use `mael gh create-pr` for PRs, `mael sync` before work. Also covers Linear task management and Sentry debugging. Always invoke /mael before commits or PRs.

Skill Health: not yet scored

Listed, not yet scored. This skill has no public model test yet. It is in the scoring queue; submitted skills go first, then the most-installed.

Version history

81 commits to this file on GitHub (newest first).

2026-10-22 · commit 076a8d2 · feat: remove mael session end; agents write <end-session>
2026-10-13 · commit 56a2957 · feat: planners draft 1-5 high-level plan-mode tasks
2026-10-13 · commit 95b5ce9 · chore: document the jig package and teach the mael skill to add it
2026-10-13 · commit 7af0590 · chore: teach the compaction request and where to write it
2026-10-13 · commit 9cbbef5 · chore: document External events, the PR watch and the re-read rule
2026-10-12 · commit 7256c2c · chore: document the Withdrawn PR, and tell agents when to withdraw
2026-10-05 · commit 2374b43 · chore: the completion flow gates on the current base
2026-10-05 · commit b9771ff · chore: split the mael skill into dev-env and verification references
2026-10-03 · commit 701159d · chore: document how to open an environment from another device
2026-10-01 · commit fbb4396 · feat: an agent writes a verification when the work has a visible result
2026-09-28 · commit 66082ef · chore: build commits say why, and build uses no fixups
2026-09-23 · commit ca433c5 · refactor: merge green into built, and give presented a place it can be seen
2026-09-21 · commit 9d76f8e · feat: report where an agent tokens went, and wire the flow to mark it
2026-09-17 · commit 797c321 · refactor: use Mael task ids for PR titles
2026-09-14 · commit f2b75d0 · docs: teach review to pick a scope, and name the two verbs apart
2026-09-13 · commit 7af4b9e · feat: review the working tree, and run present after it
2026-09-09 · commit 6af4a1a · refactor: make shared skills concise
2026-09-07 · commit 3640d60 · feat: put present in the task-completion flow, and free the build to commit [PROJ-12]
2026-09-07 · commit 2175181 · feat: add uncommit-branch, PR draft bodies and working-history prune
2026-09-07 · commit 400fa84 · refactor: remove session tracking, its MCP channel and its hooks
2026-09-07 · commit 17ebcd0 · docs: describe the image tag and the file registry
2026-09-07 · commit 864fed9 · feat: rebase a reused worktree when it is opened
2026-09-07 · commit c29e9c1 · feat: move drafts into .drafts/ and allow writes there
2026-09-01 · commit 6473dd3 · docs: carry the test re-cut carve-out to the always-on rule
2026-09-01 · commit e7e7959 · docs: record test-shaping decisions in the commit message
2026-08-18 · commit 64728ba · docs: record git and PR traps in the mael skill
2026-08-16 · commit 79fb501 · docs: document stacked branches
2026-08-14 · commit 2979599 · docs: run mael session end when a session has no work left
2026-08-13 · commit 851ebb4 · feat: draft task files replace plan files in the planning flow
2026-08-10 · commit 4e88f8f · refactor: fire scheduled tasks on the next wake, drop the pmset pre-wake
2026-08-09 · commit d14d44a · docs: cut the mael skill to conventions, defer the command surface to --help
2026-08-09 · commit 5092248 · docs: favour test-first development with agreed seams
2026-08-06 · commit 8ba4adc · feat: add mael wiki, a cross-project dev-pattern wiki
2026-08-05 · commit 8c9ef4c · feat: rework code-review into per-commit review with a shared review guide
2026-08-04 · commit 7fc382c · docs: stop agents changing branch on their own
2026-07-31 · commit 2a568c4 · fix: close the planning task before load-many --run
2026-07-30 · commit 977f6de · docs: close the task at PR submission, before the CI watch
2026-07-01 · commit f874e3e · fix: scheduled runs root their own chain
2026-06-30 · commit 503d450 · feat: fire scheduled tasks reliably + add --wake-at and schedule status
2026-06-28 · commit 293cca9 · fix: self-parent emitted tasks when launching task has no parent
2026-06-16 · commit 1bd0104 · fixup! feat: add explicit mael task status done as final task-completion step
2026-06-16 · commit 71f9cc8 · docs: default end-of-task flow to create-pr --squash then watch-pr
2026-06-16 · commit 94e8ffa · feat: add explicit mael task status done as final task-completion step
2026-06-16 · commit 78b095d · feat: make mael linear plan run by default
2026-06-15 · commit 2dbece2 · feat: auto-close tasks when the agent session ends
2026-06-14 · commit eb2b42a · feat: add mael task status todo to move tasks back to todo
2026-06-12 · commit 8366504 · feat: default new tasks to plan mode
2026-06-09 · commit a3c1a4d · feat: add `mael task load-many` + rewrite plan skills to emit a plan-file chain
2026-06-08 · commit 9726624 · feat: rewrite skills for the notebook chain; retire continue-task [ME-56]
2026-06-08 · commit d9e9d4a · feat: group task lifecycle under `status` + env id fallback
2026-06-02 · commit 5944225 · feat: add --squash flag to mael sync and gh create-pr
2026-05-29 · commit aab7aa1 · docs(mael): document `sentry resolve-issue` command
2026-05-24 · commit 47145ba · docs: switch code-review fixes to --fixup commits
2026-05-18 · commit e96a89d · feat: auto-run code-review and commits on task completion
2026-05-17 · commit 47e893b · docs: remove --wait-for-review from suggested PR workflow
2026-05-17 · commit 4007338 · feat: replace /review-branch with universal /code-review skill
2026-05-12 · commit 7bb5022 · feat(gh): add --wait-for-review to create-pr/read-pr
2026-05-12 · commit 5f0be14 · feat(gh): show all PR comments in read-pr with recency split
2026-05-12 · commit d2c92f3 · docs: document mael uptimerobot in the mael skill
2026-04-03 · commit e8e6b6e · feat: add edit-plan command for inline multi-session plan updates
2026-04-01 · commit ec3df77 · fix: download artifacts to $TMPDIR instead of cwd
2026-03-16 · commit e9dd08e · chore: rewrite mael SKILL.md to be workflow-oriented and concise
2026-03-13 · commit 89d98fc · docs: document --wait flag and clarify background execution in mael skill docs
2026-03-13 · commit cfdd0c4 · feat: add --wait flag to `mael gh read-pr` and general post-work workflow
2026-03-11 · commit 03e1350 · feat: add `mael git status` command for compact git status summary
2026-03-11 · commit 2c1772d · feat: add --progress flag to create-pr for multi-session tasks
2026-03-10 · commit 6c7437c · feat: add multi-session support for plan-task and continue-task
2026-03-04 · commit 2a10242 · fix: change PR title format from [ISSUE-ID] prefix to (Fixes ISSUE-ID) suffix
2026-03-04 · commit 483ff7d · feat: add mael status set/clear commands wrapping cmux status API
2026-02-28 · commit 6f467da · feat: workflow tweaks - product labels, PR-Linear linking, release command
2026-02-28 · commit a1e9109 · docs: clarify that mael/git commands must run outside sandbox
2026-02-27 · commit 330b58d · feat: add mael env stop-all command
2026-02-26 · commit cda495e · fix: refine parent task state transitions for subtask workflows
2026-02-17 · commit 1ba6d5a · feat: manage agent plans as resources on Linear tasks
2026-01-30 · commit 6e03606 · docs: add core workflows overview to mael skill
2026-01-30 · commit 67c69e7 · feat: add code review workflow with /review-branch command
2026-01-15 · commit 3901152 · docs: update mael skill description to emphasize mandatory git usage
2026-01-15 · commit 9413228 · feat: use force-push in mael gh create-pr
2026-01-15 · commit 294a774 · feat: add `mael install` to symlink skills and hooks to ~/.claude/
2026-01-15 · commit b13c4b9 · docs: add git/GitHub workflow to mael skill
2026-01-15 · commit a13584e · feat: add Linear and Sentry CLI integrations

Archived snapshots