Skip to content

πŸ“ Document Workflow Run Subcommand#86

Open
gilday wants to merge 1 commit into
mainfrom
worktree-iss-7252+extend-pixee-workflow-skill
Open

πŸ“ Document Workflow Run Subcommand#86
gilday wants to merge 1 commit into
mainfrom
worktree-iss-7252+extend-pixee-workflow-skill

Conversation

@gilday
Copy link
Copy Markdown
Contributor

@gilday gilday commented May 15, 2026

The pixee CLI 0.13.0 release added pixee workflow run <id> for triggering a scheduled workflow on demand. The audit-skills workflow caught the corresponding skill drift: pixee-workflow documented list, create, update, and delete but not run, so an agent asked to kick off a schedule after re-enabling it had no skill grounding.

This PR extends skills/pixee-workflow/SKILL.md with a new ## pixee workflow run section placed between update and delete in the natural workflow lifecycle. The section calls out that run targets schedule workflows specifically β€” new-scan and pull-request-scan workflows fire on their own events and have nothing for the agent to trigger manually β€” and that the verb pairs naturally with update schedule --enabled for the "re-enable, then trigger once now" pattern. A two-line example joins the existing examples block showing exactly that pairing, and a best-practices bullet captures the schedule-only constraint along with the common patterns.

The picker description is rewritten verb-first to "List, create, update, run, and delete Pixee workflows on a repository with partial-update semantics across event kinds." (119 characters, no picker-breaking punctuation). The README bullet is refreshed to match.

/close ISS-7252

The pixee CLI 0.13.0 release adds `pixee workflow run <id>` for
triggering a scheduled workflow on demand. The audit-skills workflow
caught the corresponding skill drift β€” `pixee-workflow` documented
list, create, update, and delete, but not run β€” so an agent asked to
kick off a schedule after re-enabling it had no skill grounding.

This extends `skills/pixee-workflow/SKILL.md` with a `## pixee workflow
run` section placed between `update` and `delete` in the natural
workflow lifecycle. The section calls out that `run` targets `schedule`
workflows specifically β€” `new-scan` and `pull-request-scan` workflows
fire on their own events and have nothing for the agent to trigger β€”
and pairs naturally with `update schedule --enabled` for the
"re-enable, then trigger once now" flow. A two-line example joins the
existing block showing exactly that pairing, and a best-practices
bullet captures the schedule-only constraint and the common patterns.

The picker description is rewritten to verb-first
"List, create, update, run, and delete Pixee workflows on a repository
with partial-update semantics across event kinds." (119 chars,
picker-safe). The README bullet is refreshed to match.

/close ISS-7252
@gilday gilday marked this pull request as ready for review May 20, 2026 19:26
@gilday gilday requested a review from dhafley May 20, 2026 19:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant