Skip to content

Add approve and ship workflow shortcuts - #1

Merged
craftycorvid merged 1 commit into
mainfrom
claude/skill-workflow-shortcuts-l8l8zb
Jul 29, 2026
Merged

craftycorvid merged 1 commit into
mainfrom
claude/skill-workflow-shortcuts-l8l8zb

Conversation

@craftycorvid

Copy link
Copy Markdown
Owner

Summary

This PR introduces two new workflow shortcuts to the powers plugin: approve and ship. These streamline the spec approval and PR shipping phases of the development workflow.

Key Changes

  • New approve shortcut (/powers:approve): Provides a fast path for spec approval that counts as explicit approval, commits the spec with message spec: <slug>, and automatically enters plan mode. Guards against invocation when no spec is awaiting approval.

  • New ship shortcut (/powers:ship): Automates the PR shipping workflow with six steps:

    1. Preflight checks (clean working tree, verify passes)
    2. Push branch and open PR (or reuse existing)
    3. Request Copilot's review
    4. Wait for review completion
    5. Triage and fix issues (fix real problems, skip false positives with stated reasons)
    6. Report results with PR URL, fixes, skips, and CI state
  • Updated brainstorming skill documentation: Added reference to /powers:approve as the fast path for spec approval.

  • Updated README: Added descriptions of both new shortcuts and their user-invoked-only nature.

  • Version bump: Updated plugin version from 0.3.2 to 0.4.0.

Implementation Details

Both shortcuts are marked with disable-model-invocation: true, indicating they are user-invoked commands only and do not trigger model invocation themselves. The approve shortcut includes a guard clause to prevent approval of non-existent specs. The ship shortcut provides detailed guidance on handling Copilot review comments, emphasizing that every comment must be explicitly addressed (fixed or skipped with reasoning) rather than silently ignored.

https://claude.ai/code/session_01GwXn3MfpedFs21efyk73td

Two user-invoked-only skills (disable-model-invocation) that replace
sentences typed at the same two seams every time:

- /powers:approve — spec approval fast path: commit the spec, enter
  plan mode. Counts as the explicit approval the brainstorming
  hard-gate waits for.
- /powers:ship — work-done fast path: open the PR, request and wait
  for Copilot's review, fix what's relevant, state why the rest was
  skipped.

Brainstorming skill and README point at the shortcuts; plugin bumped
to 0.4.0.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GwXn3MfpedFs21efyk73td
Copilot AI review requested due to automatic review settings July 29, 2026 16:48

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds two user-invoked workflow shortcuts to the powers plugin—/powers:approve for spec approval → commit → plan, and /powers:ship for opening/shipping a PR with a Copilot review loop—plus documentation updates and a version bump to publish the new capabilities.

Changes:

  • Added new approve and ship shortcut skill definitions (both marked disable-model-invocation: true).
  • Updated existing skill/README documentation to reference and describe the new shortcuts.
  • Bumped plugin version from 0.3.2 to 0.4.0.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file
File Description
skills/ship/SKILL.md Introduces the /powers:ship shortcut guidance for PR creation + Copilot review triage workflow.
skills/approve/SKILL.md Introduces the /powers:approve shortcut guidance to guard, commit the spec, and enter plan mode.
skills/brainstorming/SKILL.md Documents /powers:approve as the fast-path after spec review/approval.
README.md Adds user-facing descriptions for the new approve and ship shortcuts.
.claude-plugin/plugin.json Version bump to 0.4.0 to reflect the new shortcuts.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@craftycorvid
craftycorvid merged commit e174bf3 into main Jul 29, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants