Contributing
Agent Skills
Packaged agent skills for coding assistants to use DubStack correctly.
DubStack ships packaged skills so coding assistants can use dub correctly for stacked PR workflows.
Included Skills
dubstack
General CLI reference and workflow guidance for creating and navigating stacks, modifying branches and restacking, syncing with remote state, submitting PR stacks, and recovering from common errors.
npx skills add wiseiodev/dubstack/skills/dubstackdub-flow
Task-oriented PR execution flow for agents that need to analyze staged changes, propose branch + commit naming, run dub create / dub submit, and open and polish PR metadata.
npx skills add wiseiodev/dubstack/skills/dub-flowInstall via DubStack CLI
# Install all packaged skills
dub skills add
# Install specific skill
dub skills add dubstack
dub skills add dub-flowRemove Skills
dub skills remove dubstack
dub skills remove dub-flowDry Run
Preview changes without modifying anything:
dub skills add --dry-run
dub skills remove --dry-runWhat Agents Gain
With these skills installed, agents are more reliable at:
- Using stack-safe commands (
create,modify,sync,restack,submit) - Choosing safer recovery paths after conflicts
- Avoiding destructive or non-stack-aware git flows
- Producing consistent PR workflow outputs
dub-flow Workflow Phases
The dub-flow skill guides agents through a structured 4-phase PR creation process:
- Analyze Changes — Inspect staged diffs, determine scope (feature/fix/refactor/etc.)
- Propose Naming — Suggest branch name (
type/short-kebab-scope) and conventional commit message - Confirm — Present plan to user for approval before execution
- Execute — Run
dub create+dub ss