feat: remove four superseded reference skills #33

Merged
jercik merged 1 commit from feat/remove-reference-skills into main 2026-08-05 06:02:33 +00:00
Owner

Skills-triage batch 1 (first half): removes fastify-zod-reference, typescript-magician, to-prd, and to-issues — imported reference material that duplicates or contradicts the align rule corpus (default exports, hand-rolled type guards over Zod, bare tsc --noEmit, npm flows on a pnpm fleet, a dead /setup-matt-pocock-skills prerequisite). Nothing else in the repo references any of the four. The node skill's trim to its unique subjects follows as its own PR.

Skills-triage batch 1 (first half): removes `fastify-zod-reference`, `typescript-magician`, `to-prd`, and `to-issues` — imported reference material that duplicates or contradicts the align rule corpus (default exports, hand-rolled type guards over Zod, bare `tsc --noEmit`, npm flows on a pnpm fleet, a dead `/setup-matt-pocock-skills` prerequisite). Nothing else in the repo references any of the four. The `node` skill's trim to its unique subjects follows as its own PR.
feat: remove four superseded reference skills
Some checks failed
Node tests / node:test (pull_request) Successful in 11s
commit-msg / commitlint (pull_request) Successful in 20s
PR Review / Prepare immutable review tools (pull_request_target) Successful in 1m30s
PR Review / forgejo-review-approach-3 generator (pull_request_target) Failing after 49s
PR Review / forgejo-review-code-smart-2 generator (pull_request_target) Failing after 48s
PR Review / forgejo-review-approach-smart-2 generator (pull_request_target) Failing after 49s
PR Review / forgejo-review-approach-smart-1 generator (pull_request_target) Successful in 1m43s
PR Review / forgejo-review-code-smart-1 generator (pull_request_target) Successful in 2m21s
PR Review / Dispatch and observe exact review writers (pull_request_target) Failing after 2m33s
fc8db20cc7
forgejo-actions left a comment

Approach review: The approach looks good.

This is a pure removal: 37 files deleted, zero added or modified lines, and each of the four skill directories (fastify-zod-reference, typescript-magician, to-prd, to-issues) is removed in full with no orphaned files left behind. That matches the stated intent exactly.

Deletion is the right mechanism here rather than the alternatives:

  • Since the directory name under skills/ is the selectable skill name and description is the only picker metadata, there is no deprecation or tombstone mechanism in this source format that would be more graceful than removing the directory. A stub SKILL.md marked deprecated would keep the entry in the picker and in axskills sync's managed copies, which is strictly worse than removing it.
  • Rewriting the four to match the align rule corpus instead of deleting them would be a much larger change, and the PR body's rationale (duplicated or contradicted guidance: default exports, hand-rolled type guards over Zod, bare tsc --noEmit, npm flows on a pnpm fleet, a dead /setup-matt-pocock-skills prerequisite) is a content judgment, not an approach one.
  • Splitting the triage into batches with the node skill trim as a separate PR keeps each change independently reviewable and revertable, which is appropriate for bulk content removal of this size.

I confirmed nothing else in the repository references the removed skills by name (including setup-matt-pocock), so no dangling cross-references or README entries are left to clean up. Git history preserves the removed content if any of it needs to be recovered later.

No material alternative to suggest.

Approach review by Claude Code Opus (opus)

**Approach review:** The approach looks good. This is a pure removal: 37 files deleted, zero added or modified lines, and each of the four skill directories (`fastify-zod-reference`, `typescript-magician`, `to-prd`, `to-issues`) is removed in full with no orphaned files left behind. That matches the stated intent exactly. Deletion is the right mechanism here rather than the alternatives: - Since the directory name under `skills/` *is* the selectable skill name and `description` is the only picker metadata, there is no deprecation or tombstone mechanism in this source format that would be more graceful than removing the directory. A stub `SKILL.md` marked deprecated would keep the entry in the picker and in `axskills sync`'s managed copies, which is strictly worse than removing it. - Rewriting the four to match the align rule corpus instead of deleting them would be a much larger change, and the PR body's rationale (duplicated or contradicted guidance: default exports, hand-rolled type guards over Zod, bare `tsc --noEmit`, npm flows on a pnpm fleet, a dead `/setup-matt-pocock-skills` prerequisite) is a content judgment, not an approach one. - Splitting the triage into batches with the `node` skill trim as a separate PR keeps each change independently reviewable and revertable, which is appropriate for bulk content removal of this size. I confirmed nothing else in the repository references the removed skills by name (including `setup-matt-pocock`), so no dangling cross-references or README entries are left to clean up. Git history preserves the removed content if any of it needs to be recovered later. No material alternative to suggest. _Approach review by Claude Code Opus (opus)_ <!-- axrecipe-review:v1:eyJzY2hlbWFWZXJzaW9uIjoxLCJzdGF0ZSI6InB1Ymxpc2hlZCIsInJlcG9zaXRvcnkiOiJqNGstb3NzL2FnZW50LXNraWxscyIsIm51bWJlciI6IjMzIiwiaGVhZFNoYSI6ImZjOGRiMjBjYzc3YTZkMzcyYTZlOGNhZjIzYTkyMTI5N2E3OWI1MDgiLCJzbG90IjoiZm9yZ2Vqby1yZXZpZXctYXBwcm9hY2gtc21hcnQtMSIsInNvdXJjZVdvcmtmbG93UnVuSWQiOiIxNjcxMyIsInNvdXJjZUdlbmVyYXRvckF0dGVtcHQiOiIxIiwicmVzdWx0SWQiOiJmZDIxZDM5MS0wNjcyLTQ5ZjktYmUyZC1hOTUyNDAwNmVjMDkifQ== -->
forgejo-actions left a comment

Summary: No actionable issues found.

This PR is a pure deletion of four skill directories (37 files, 13,392 deletions, no additions or renames). Verification performed against the working tree:

  • No dangling references. A repo-wide search (excluding .git) for fastify-zod-reference, typescript-magician, to-prd, to-issues, and setup-matt-pocock returns nothing, so no surviving skill, README section, workflow, or hook links to the removed material. The README documents the layout generically (skills/<skill-name>/SKILL.md) rather than enumerating skills, so it needs no update.
  • No CI impact. .forgejo/workflows/node-test.yml guards against stale inputs by comparing the tracked *.test.{js,cjs,mjs,ts,cts,mts} and package.json sets against a baked-in base64 list. Post-deletion, git ls-files for those globs still yields exactly skills/node/rules/assets/graceful-server.test.ts, matching the encoded expectation — the deletions are all .md, so the staleness check does not trip and no j4k-align refresh is required.
  • Stated rationale holds. The removed to-prd and to-issues skills both instruct the agent to run /setup-matt-pocock-skills, a command that exists nowhere in this repository; typescript-magician teaches a hand-rolled isUser(value): value is User guard and a bare tsc --noEmit loop, which conflict with the align corpus's Parse-Don't-Validate rule.
  • No leftovers. The four directories are fully removed from skills/, with no orphaned assets or partially-deleted rule trees.

Code review by Claude Code Opus (opus)

**Summary:** No actionable issues found. This PR is a pure deletion of four skill directories (37 files, 13,392 deletions, no additions or renames). Verification performed against the working tree: - **No dangling references.** A repo-wide search (excluding `.git`) for `fastify-zod-reference`, `typescript-magician`, `to-prd`, `to-issues`, and `setup-matt-pocock` returns nothing, so no surviving skill, README section, workflow, or hook links to the removed material. The README documents the layout generically (`skills/<skill-name>/SKILL.md`) rather than enumerating skills, so it needs no update. - **No CI impact.** `.forgejo/workflows/node-test.yml` guards against stale inputs by comparing the tracked `*.test.{js,cjs,mjs,ts,cts,mts}` and `package.json` sets against a baked-in base64 list. Post-deletion, `git ls-files` for those globs still yields exactly `skills/node/rules/assets/graceful-server.test.ts`, matching the encoded expectation — the deletions are all `.md`, so the staleness check does not trip and no `j4k-align` refresh is required. - **Stated rationale holds.** The removed `to-prd` and `to-issues` skills both instruct the agent to run `/setup-matt-pocock-skills`, a command that exists nowhere in this repository; `typescript-magician` teaches a hand-rolled `isUser(value): value is User` guard and a bare `tsc --noEmit` loop, which conflict with the align corpus's Parse-Don't-Validate rule. - **No leftovers.** The four directories are fully removed from `skills/`, with no orphaned assets or partially-deleted rule trees. _Code review by Claude Code Opus (opus)_ <!-- axrecipe-review:v1:eyJzY2hlbWFWZXJzaW9uIjoxLCJzdGF0ZSI6InB1Ymxpc2hlZCIsInJlcG9zaXRvcnkiOiJqNGstb3NzL2FnZW50LXNraWxscyIsIm51bWJlciI6IjMzIiwiaGVhZFNoYSI6ImZjOGRiMjBjYzc3YTZkMzcyYTZlOGNhZjIzYTkyMTI5N2E3OWI1MDgiLCJzbG90IjoiZm9yZ2Vqby1yZXZpZXctY29kZS1zbWFydC0xIiwic291cmNlV29ya2Zsb3dSdW5JZCI6IjE2NzEzIiwic291cmNlR2VuZXJhdG9yQXR0ZW1wdCI6IjEiLCJyZXN1bHRJZCI6IjAxMTAwOGQ5LTU5MTItNDdkZC1hM2IzLThmNGYxOGQyZGYwNiJ9 -->
jercik merged commit 495b4a9bf0 into main 2026-08-05 06:02:33 +00:00
jercik deleted branch feat/remove-reference-skills 2026-08-05 06:02:33 +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!33
No description provided.