packages/sc-commit-push-pr/skills/sc-commit-push-pr/SKILL.md
Commit staged changes, push to remote, and create PRs for GitHub and Azure DevOps
npx skillsauth add randlee/synaptic-canvas sc-commit-push-prInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Orchestrates the commit, push, and PR creation workflow using background agents.
| Command | Description |
|---------|-------------|
| /sc-commit-push-pr | Full pipeline: commit, push, and create PR if needed |
| /sc-create-pr | Create PR from title/body (standalone) |
| Step | Agent | Input | Output |
|------|-------|-------|--------|
| Commit & Push | commit-push | source/destination branches | PR status, URL, or conflict list |
| Create PR | create-pr | title, body, source, destination | PR info |
/sc-commit-push-pr FlowStage important files
Invoke commit-push agent via Agent Runner
Handle response:
pr_exists: true → Return PR URL to userneeds_pr_text: true → Prompt user for title/body, then invoke create-prerror.code == "GIT.MERGE_CONFLICT" → Guide user through conflict resolution/sc-create-pr FlowAccept title/body from user
Invoke create-pr agent via Agent Runner
Return PR URL to user
gh CLI for PR operationsAZURE_DEVOPS_PATProvider is auto-detected from git remote on each run.
Create .sc/shared-settings.yaml:
git:
protected_branches:
- main
- develop
Or let the skill auto-detect from git-flow configuration.
Set environment variables:
GITHUB_TOKEN (or gh auth login)AZURE_DEVOPS_PAT| Error Code | Meaning | Recovery |
|------------|---------|----------|
| GIT.MERGE_CONFLICT | Merge conflicts detected | Resolve conflicts, re-run |
| GIT.AUTH | Authentication failure | Check credentials |
| PR.CREATE_FAILED | API error creating PR | Check permissions |
| CONFIG.PROTECTED_BRANCH_NOT_SET | Missing config | Create shared-settings.yaml |
| Type | Path | Purpose |
|------|------|---------|
| Logs | .claude/state/logs/sc-commit-push-pr/ | Runtime events, preflight results |
| Shared Settings | .sc/shared-settings.yaml | Protected branch configuration |
| Package Settings | .sc/sc-commit-push-pr/settings.yaml | Optional preferences |
tools
Set up a repo-local just task runner with a root Justfile, optional .just/ helper scripts, and curated help, build, fmt, lint, test, and ci recipes. Use when a repo needs just, a Justfile, .just helpers, or when the user mentions task automation, "just build", "just lint", "just fmt", or dropping in a just system.
tools
Convert PDF documents to markdown, extract images and tables using the docling CLI. Use when asked to convert a PDF, extract a datasheet, get images from a PDF, or process any document into structured output. Triggers: 'convert pdf', 'pdf to markdown', 'extract images from pdf', 'datasheet', 'get tables from pdf', 'extract diagrams'. No MCP required — uses docling CLI only.
development
Use when another workflow must launch Claude, Codex, or Gemini as a separate background sub-agent without opening a terminal. Spawns the `launchpad` agent with fenced JSON input and `run_in_background: true`.
testing
Run repo startup: prompt load, checklist sync, optional PR triage, worktree hygiene, and CI pull. Best-effort with structured status.