From 3f5a431cbafc62d158df4ee54374f07426b7060a Mon Sep 17 00:00:00 2001 From: Richard Levasseur Date: Wed, 5 Aug 2026 04:21:00 +0000 Subject: [PATCH] agents: update create-pr skill with interactive artifact requirements Update the create-pr skill to specify interactive user-facing artifact requirements and explicit user decision options when proposing PRs. Previously, the create-pr skill instructions lacked explicit requirements for user-facing markdown artifacts with interactive feedback enabled, as well as defined options for user decision workflows. To address this, the SKILL.md documentation is updated to require user-facing artifacts with interactive feedback enabled and to outline the four decision choices for user review. --- .agents/skills/create-pr/SKILL.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/.agents/skills/create-pr/SKILL.md b/.agents/skills/create-pr/SKILL.md index 3510b15d07..88b687b39f 100644 --- a/.agents/skills/create-pr/SKILL.md +++ b/.agents/skills/create-pr/SKILL.md @@ -28,8 +28,14 @@ to handle PR creation or description drafting. (GitHub uses the PR description as the commit message upon merge, which reflows text at 72 columns). - **Formatting**: Follow repository style guidelines and structure. - - Create a Markdown artifact (`pr_info.md`) containing the PR title, body, - and link/metadata so the user can review and comment on it. + - Create a Markdown artifact (`pr_info.md`) meeting the following requirements: + - **User-facing**: Published so it is presented directly in the user interface. + - **Interactive feedback enabled**: Allows the user to select lines and leave inline comments on the draft. + - **User decision choices**: Ask the user if they want to: + 1. Create a regular PR + 2. Create a draft PR + 3. Provide feedback on the draft text + 4. Discard the draft text - **Propose vs. Create**: If the user requested to propose or draft a PR description, **do not** run `gh pr create`—just create the `pr_info.md` artifact for the user to review. Otherwise, execute `gh pr create` with