feat: remove the create-prs-with-gh skill #32

Merged
jercik merged 1 commit from feat/delete-create-prs-with-gh into main 2026-08-05 05:29:20 +00:00
Owner

Estate-triage decision: the skill duplicates the corpus rule that already teaches the gh quoting mechanics (single-quoted heredoc into --body-file -), and its content guidance now lives in human-facing-writing-style's Pull requests section. Nothing else references it. Supersedes #31.

Estate-triage decision: the skill duplicates the corpus rule that already teaches the `gh` quoting mechanics (single-quoted heredoc into `--body-file -`), and its content guidance now lives in `human-facing-writing-style`'s Pull requests section. Nothing else references it. Supersedes #31.
feat: remove the create-prs-with-gh skill
Some checks failed
Node tests / node:test (pull_request) Successful in 9s
commit-msg / commitlint (pull_request) Successful in 18s
PR Review / Prepare immutable review tools (pull_request_target) Successful in 1m35s
PR Review / forgejo-review-approach-smart-2 generator (pull_request_target) Failing after 52s
PR Review / forgejo-review-approach-3 generator (pull_request_target) Failing after 52s
PR Review / forgejo-review-code-smart-2 generator (pull_request_target) Failing after 51s
PR Review / forgejo-review-approach-smart-1 generator (pull_request_target) Successful in 2m9s
PR Review / forgejo-review-code-smart-1 generator (pull_request_target) Successful in 2m29s
PR Review / Dispatch and observe exact review writers (pull_request_target) Failing after 2m48s
5d3eef761c
forgejo-actions left a comment

Approach review: Deleting the skill outright is the right shape for this change, and I found no materially better alternative.

What I checked in the working tree:

  • The change is a single-file deletion and the skills/create-prs-with-gh/ directory is gone, which is all axskills needs: the source's selectable names are the directory names, and axskills sync prunes its managed copies in ~/.claude/skills, so a removed skill disappears on the next sync. There is no alias or tombstone mechanism to maintain, so a redirect stub would only be a name that keeps occupying the picker.
  • Nothing references the skill. Grepping the tree (excluding .git) for the skill name, gh pr create, and body-file returns no hits, and scripts/ holds only a test reporter — there is no manifest or index that enumerates skills and would need a matching edit.
  • The content-guidance claim holds. skills/human-facing-writing-style/SKILL.md:267 carries the ## Pull requests section (titles, body shape, what gets cut), and that skill's description already triggers on "draft a PR description", so the routing the removed skill provided for content questions is preserved.

One thing I could not verify from this checkout, flagged rather than objected to: the claim that the gh quoting mechanics (single-quoted heredoc into --body-file -) live in a corpus rule. This repository ships skills only and vendors no rules/ tree, so the corpus is out of reach here. The rendered AGENTS.md covers shell-injection safety in general terms but does not teach the --body-file - heredoc form specifically. If the corpus rule is in fact the only remaining home for that mechanic, it is worth confirming it is in the always-on selection before this merges — moving a mechanical trap from an opt-in skill to an always-delivered rule is an improvement, but only once the rule actually carries it.

Approach review by Claude Code Opus (opus)

**Approach review:** Deleting the skill outright is the right shape for this change, and I found no materially better alternative. What I checked in the working tree: - The change is a single-file deletion and the `skills/create-prs-with-gh/` directory is gone, which is all `axskills` needs: the source's selectable names are the directory names, and `axskills sync` prunes its managed copies in `~/.claude/skills`, so a removed skill disappears on the next sync. There is no alias or tombstone mechanism to maintain, so a redirect stub would only be a name that keeps occupying the picker. - Nothing references the skill. Grepping the tree (excluding `.git`) for the skill name, `gh pr create`, and `body-file` returns no hits, and `scripts/` holds only a test reporter — there is no manifest or index that enumerates skills and would need a matching edit. - The content-guidance claim holds. `skills/human-facing-writing-style/SKILL.md:267` carries the `## Pull requests` section (titles, body shape, what gets cut), and that skill's `description` already triggers on "draft a PR description", so the routing the removed skill provided for content questions is preserved. One thing I could not verify from this checkout, flagged rather than objected to: the claim that the `gh` quoting mechanics (single-quoted heredoc into `--body-file -`) live in a corpus rule. This repository ships skills only and vendors no `rules/` tree, so the corpus is out of reach here. The rendered `AGENTS.md` covers shell-injection safety in general terms but does not teach the `--body-file -` heredoc form specifically. If the corpus rule is in fact the only remaining home for that mechanic, it is worth confirming it is in the always-on selection before this merges — moving a mechanical trap from an opt-in skill to an always-delivered rule is an improvement, but only once the rule actually carries it. _Approach review by Claude Code Opus (opus)_ <!-- axrecipe-review:v1:eyJzY2hlbWFWZXJzaW9uIjoxLCJzdGF0ZSI6InB1Ymxpc2hlZCIsInJlcG9zaXRvcnkiOiJqNGstb3NzL2FnZW50LXNraWxscyIsIm51bWJlciI6IjMyIiwiaGVhZFNoYSI6IjVkM2VlZjc2MWNiYjExMDJkMjlmNWY3MmM4NzIyZDVkNTAzNTY4ZmIiLCJzbG90IjoiZm9yZ2Vqby1yZXZpZXctYXBwcm9hY2gtc21hcnQtMSIsInNvdXJjZVdvcmtmbG93UnVuSWQiOiIxNjQzMCIsInNvdXJjZUdlbmVyYXRvckF0dGVtcHQiOiIxIiwicmVzdWx0SWQiOiI4MzMzM2VkYy1lOTdhLTRjMzYtODJlNC0wNmE1NmFkMjkxNDgifQ== -->
forgejo-actions left a comment

Summary: Clean deletion; 1 informational note.

Verified against the working tree:

  • skills/create-prs-with-gh/ is fully removed (the single SKILL.md was its only file); no orphan directory remains.
  • grep -rn create-prs-with-gh over the tree (excluding .git) returns nothing, so the PR's "nothing else references it" claim holds. The repo has no skill manifest or index — README.md documents the layout without enumerating skills, and the .forgejo workflows don't list skill names — so nothing else needs updating.
  • The content-guidance claim holds: skills/human-facing-writing-style/SKILL.md:267 carries the "Pull requests" section (titles, body, what gets cut), and its frontmatter description already triggers on "write the PR title or body" and "draft a PR description", so the discovery path for PR-writing guidance survives the removal.

The one thing I could not verify from this repository is the shell-quoting half of the claim; see the inline note.

Code review by Claude Code Opus (opus)

**Summary:** Clean deletion; 1 informational note. Verified against the working tree: - `skills/create-prs-with-gh/` is fully removed (the single `SKILL.md` was its only file); no orphan directory remains. - `grep -rn create-prs-with-gh` over the tree (excluding `.git`) returns nothing, so the PR's "nothing else references it" claim holds. The repo has no skill manifest or index — `README.md` documents the layout without enumerating skills, and the `.forgejo` workflows don't list skill names — so nothing else needs updating. - The content-guidance claim holds: `skills/human-facing-writing-style/SKILL.md:267` carries the "Pull requests" section (titles, body, what gets cut), and its frontmatter description already triggers on "write the PR title or body" and "draft a PR description", so the discovery path for PR-writing guidance survives the removal. The one thing I could not verify from this repository is the shell-quoting half of the claim; see the inline note. _Code review by Claude Code Opus (opus)_ <!-- axrecipe-review:v1:eyJzY2hlbWFWZXJzaW9uIjoxLCJzdGF0ZSI6InB1Ymxpc2hlZCIsInJlcG9zaXRvcnkiOiJqNGstb3NzL2FnZW50LXNraWxscyIsIm51bWJlciI6IjMyIiwiaGVhZFNoYSI6IjVkM2VlZjc2MWNiYjExMDJkMjlmNWY3MmM4NzIyZDVkNTAzNTY4ZmIiLCJzbG90IjoiZm9yZ2Vqby1yZXZpZXctY29kZS1zbWFydC0xIiwic291cmNlV29ya2Zsb3dSdW5JZCI6IjE2NDMwIiwic291cmNlR2VuZXJhdG9yQXR0ZW1wdCI6IjEiLCJyZXN1bHRJZCI6ImU3YjJiMjk1LTAzYTAtNDJiNy05MTMyLWM3MTFjZWRmZDc5YyJ9 -->
@ -9,4 +0,0 @@
# Reference
**Don't put Markdown in a double-quoted `--body` string.** The shell expands backticks and `$...` before `gh` sees it, mangling code blocks and variable references.

ℹ️ Info: The content guidance clearly survives in human-facing-writing-style, but I could not confirm the quoting mechanics do. This repo's rendered AGENTS.md "Safe Command Execution" rule covers command arrays and variable interpolation into sh -c/eval/ssh strings — it never mentions gh, --body-file -, or the single-quoted heredoc, and the failure mode here is different (the shell expanding backticks and $... inside a double-quoted literal, with no variable involved). No other file in the tree mentions gh pr create or --body-file. If the corpus rule that teaches this is one that simply isn't selected for this repository, the claim stands and nothing needs doing; if the corpus only carries the interpolation rule quoted in AGENTS.md, this specific trap is being dropped rather than deduplicated. Worth confirming in the corpus before merge. Note also that this repo is on Forgejo and AGENTS.md directs forge-side mutations to fgj, which makes a gh-specific skill a weaker fit here regardless.

ℹ️ **Info:** The content guidance clearly survives in `human-facing-writing-style`, but I could not confirm the quoting mechanics do. This repo's rendered `AGENTS.md` "Safe Command Execution" rule covers command arrays and variable interpolation into `sh -c`/`eval`/`ssh` strings — it never mentions `gh`, `--body-file -`, or the single-quoted heredoc, and the failure mode here is different (the shell expanding backticks and `$...` inside a double-quoted literal, with no variable involved). No other file in the tree mentions `gh pr create` or `--body-file`. If the corpus rule that teaches this is one that simply isn't selected for this repository, the claim stands and nothing needs doing; if the corpus only carries the interpolation rule quoted in `AGENTS.md`, this specific trap is being dropped rather than deduplicated. Worth confirming in the corpus before merge. Note also that this repo is on Forgejo and `AGENTS.md` directs forge-side mutations to `fgj`, which makes a `gh`-specific skill a weaker fit here regardless.
jercik marked this conversation as resolved
Author
Owner

Adjudication — 41652 (Info, the only finding; both surviving slots converged on it): confirmed in the corpus, no change needed. The quoting mechanics survive verbatim in j4k/align:rules/ai-coding-workflow/creating-prs.md — its GitHub half is the exact gh pr create --body-file - <<'EOF' single-quoted-heredoc pattern this skill taught (lines 7–12), and it adds the fgj equivalent this gh-only skill lacked. The reviewers couldn't see it because this repo vendors no rules tree: ai-coding-workflow is one of the two GLOBAL_SHARED_CATEGORIES (src/agent-instructions/global-targets.ts:28), so the rule renders into all five workstation globals and reaches every agent session on the machine without any skill invocation — always-on, not opt-in. The deletion deduplicates; it drops nothing. Resolving.

(The three failed generator slots are the known fleet-wide capability-exchange regression — sixth consecutive failure for code-smart-2, second for the approach slots — service-side, unrelated to this PR.)

**Adjudication — 41652 (Info, the only finding; both surviving slots converged on it):** confirmed in the corpus, no change needed. The quoting mechanics survive verbatim in `j4k/align:rules/ai-coding-workflow/creating-prs.md` — its GitHub half is the exact `gh pr create --body-file - <<'EOF'` single-quoted-heredoc pattern this skill taught (lines 7–12), and it adds the `fgj` equivalent this `gh`-only skill lacked. The reviewers couldn't see it because this repo vendors no rules tree: `ai-coding-workflow` is one of the two `GLOBAL_SHARED_CATEGORIES` (`src/agent-instructions/global-targets.ts:28`), so the rule renders into all five workstation globals and reaches every agent session on the machine without any skill invocation — always-on, not opt-in. The deletion deduplicates; it drops nothing. Resolving. (The three failed generator slots are the known fleet-wide capability-exchange regression — sixth consecutive failure for `code-smart-2`, second for the approach slots — service-side, unrelated to this PR.)
jercik merged commit 07bc9b1c2c into main 2026-08-05 05:29:20 +00:00
jercik deleted branch feat/delete-create-prs-with-gh 2026-08-05 05:29:20 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
j4k-oss/agent-skills!32
No description provided.