refactor(me): optimize create-pr skill for token efficiency

[baleen37]

Summary

• Reduce SKILL.md from 276 to 153 lines (44% token reduction)
• Move detailed documentation to references/ directory structure
• Optimize conflict-check.sh to accept BASE as argument (eliminates redundant calculation)
• Consolidate duplicate auto-merge sections into single source of truth
• Apply 2026 best practices: concise, imperative language, no watermarks

Test plan

• Tested skill workflow end-to-end
• Verified conflict detection works with BASE argument
• Confirmed all references resolve correctly

Summary by CodeRabbit

• Documentation
  • Reorganized create-pr workflow documentation with streamlined quick start guide
  • Updated checklist items, pre-flight checks, and workflow step sequences
  • Enhanced conflict resolution process with improved error messages and resolution guidance
  • Refined PR workflow documentation with state-based PR action tables and consolidated guidelines

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

This PR restructures the create-pr skill documentation from a procedural implementation guide to a principle-driven workflow, updates the quick-start checklist with renumbered steps and refined guidance, and improves the conflict-check.sh script with explicit base branch argument handling and merge-base calculations instead of direct remote merge operations.

Changes

Cohort / File(s)	Summary
Documentation restructuring plugins/me/skills/create-pr/QUICK_START.md, plugins/me/skills/create-pr/SKILL.md	Significant rewrite of SKILL.md from "Overview + Implementation (6 Steps)" format to "Core Principles + Workflow (5 Steps)" structure. Updated QUICK_START.md with renumbered workflow steps, refined conflict check guidance referencing script invocation, and rewritten PR state action tables. Consolidated verbose sections into compact tables for error handling and guardrails.
Script logic refinement plugins/me/skills/create-pr/scripts/conflict-check.sh	Changed base branch handling from remote derivation to explicit argument with "main" default. Added fetch error handling, merge-base calculation and validation, and updated conflict detection to use computed merge-base instead of direct origin merge. Enhanced error messaging with explicit resolution steps and guide references.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~22 minutes

Possibly related PRs

• feat(me): add orchestrate and verify commands with argument support #24: Updates PR-creation workflow and flag handling including --draft/--automerge behavior and PR state/actions configuration, aligning with this PR's documentation restructuring and state-aware PR workflow changes.

Suggested labels

released

Poem

🐰 A rabbit hops through the workflow,
Restructured neat, from chaos to flow,
Conflicts now checked with merge-base delight,
Fast reference guides make PR paths bright!
Create-pr skill bounces—refined and tight! ✨

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}