Smart Sapling Commit

Create well-formatted commits following the Conventional Commits specification using Sapling SCM.

<EXTREMELY_IMPORTANT>

Windows Note: Use the full path to sl.exe to avoid conflicts with PowerShell's built-in sl alias for Set-Location. </EXTREMELY_IMPORTANT>

What This Skill Does

1. Checks which files have changes with sl status
2. If there are untracked files to include, adds them with sl add
3. Performs a sl diff to understand what changes are being committed
4. Analyzes the diff to determine if multiple distinct logical changes are present
5. If multiple distinct changes are detected, suggests breaking the commit into multiple smaller commits
6. For each commit, creates a commit message using conventional commit format

Commands to Use

• sl status - Check repository state
• sl diff - View pending changes
• sl add <files> - Add untracked files
• sl commit -m "<message>" - Create commit

Key Sapling Differences from Git

• No staging area: Sapling commits all pending changes directly
• Amend with auto-restack: sl amend automatically rebases descendant commits
• Stacked Diffs: Each commit becomes a separate Phabricator diff

Sapling Commit Commands Reference

Important Notes

• Follow pre-commit checks if configured
• Keep commits small and focused - each becomes a separate Phabricator diff
• Use sl amend freely - Sapling handles rebasing automatically
• Attribute AI-assisted code authorship