Publish Matt Pocock engineering skills under boxuan-zhao - #1
Merged
Conversation
Changes: - Allow an optional package directory between owner and skill - Document standalone and packaged catalog layouts Impact: - Upstream suites can stay grouped while each skill remains independently installable - Existing two-level skill paths remain compatible Verification: - python scripts/validate_skills.py - npx skills@latest add . --list - git diff --check
Changes: - Add 26 stable skills under skills/boxuan-zhao/matt-pocock - Add suite metadata, upstream revision, and MIT license Impact: - Keeps the upstream suite grouped while preserving per-skill discovery - Excludes deprecated, in-progress, and personal upstream categories Verification: - python scripts/validate_skills.py - npx skills@latest add . --list - git diff --check
Changes: - Add --full-depth to catalog discovery and install examples - Explain mixed-depth CLI traversal behavior Impact: - Ensures packaged skills remain visible alongside standalone skills Verification: - python scripts/validate_skills.py - npx skills@latest add . --list --full-depth - git diff --check
boxuan-zhao
force-pushed
the
agent/publish-matt-pocock-skills
branch
from
July 11, 2026 18:37
ab277d6 to
edc3258
Compare
boxuan-zhao
marked this pull request as ready for review
July 11, 2026 18:42
There was a problem hiding this comment.
Pull request overview
Publishes Matt Pocock’s stable engineering/productivity/utility skill suite under skills/boxuan-zhao/matt-pocock/, and updates the repository catalog tooling/docs to support an optional <package-name>/ level in the skills layout.
Changes:
- Added the
matt-pocockpackaged skill suite (skills + supporting reference docs/scripts + license). - Updated
scripts/validate_skills.pyto validate bothskills/<owner>/<skill>/SKILL.mdandskills/<owner>/<package>/<skill>/SKILL.mdlayouts. - Updated
README.mdandCONTRIBUTING.mdto document packaged layout usage and--full-depthfor theskillsCLI.
Reviewed changes
Copilot reviewed 54 out of 54 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| README.md | Documents optional package level + --full-depth usage for discovery/installation. |
| CONTRIBUTING.md | Documents when/how to use skills/<owner>/<package>/<skill>/ and validation commands. |
| scripts/validate_skills.py | Validates skill catalogs using either 2-level or 3-level (packaged) layouts. |
| skills/boxuan-zhao/matt-pocock/PACKAGE.md | Describes the mirrored upstream suite, source commit/date, and included skills. |
| skills/boxuan-zhao/matt-pocock/LICENSE | MIT license text for the mirrored suite. |
| skills/boxuan-zhao/matt-pocock/ask-matt/SKILL.md | Adds the “ask-matt” router skill for choosing an appropriate flow/skill. |
| skills/boxuan-zhao/matt-pocock/code-review/SKILL.md | Adds a two-axis (Standards + Spec) review workflow skill. |
| skills/boxuan-zhao/matt-pocock/codebase-design/SKILL.md | Adds deep-module vocabulary and design guidance skill. |
| skills/boxuan-zhao/matt-pocock/codebase-design/DEEPENING.md | Adds reference on deepening strategies and dependency categories. |
| skills/boxuan-zhao/matt-pocock/codebase-design/DESIGN-IT-TWICE.md | Adds reference for parallel interface-design exploration. |
| skills/boxuan-zhao/matt-pocock/diagnosing-bugs/SKILL.md | Adds structured debugging/diagnosis workflow skill. |
| skills/boxuan-zhao/matt-pocock/diagnosing-bugs/scripts/hitl-loop.template.sh | Adds HITL repro-loop script template for diagnosis workflows. |
| skills/boxuan-zhao/matt-pocock/domain-modeling/SKILL.md | Adds domain modeling workflow skill. |
| skills/boxuan-zhao/matt-pocock/domain-modeling/CONTEXT-FORMAT.md | Adds reference template for CONTEXT.md glossary structure. |
| skills/boxuan-zhao/matt-pocock/domain-modeling/ADR-FORMAT.md | Adds reference template for ADRs. |
| skills/boxuan-zhao/matt-pocock/git-guardrails-claude-code/SKILL.md | Adds skill for configuring Claude Code git safety hooks. |
| skills/boxuan-zhao/matt-pocock/git-guardrails-claude-code/scripts/block-dangerous-git.sh | Adds hook script to block dangerous git commands. |
| skills/boxuan-zhao/matt-pocock/grill-me/SKILL.md | Adds stateless grilling workflow skill. |
| skills/boxuan-zhao/matt-pocock/grill-with-docs/SKILL.md | Adds grilling workflow that also maintains domain docs. |
| skills/boxuan-zhao/matt-pocock/grilling/SKILL.md | Adds the core “grilling” interview primitive skill. |
| skills/boxuan-zhao/matt-pocock/handoff/SKILL.md | Adds skill to write a handoff document for a fresh agent/session. |
| skills/boxuan-zhao/matt-pocock/implement/SKILL.md | Adds an implementation workflow skill (optionally TDD-driven). |
| skills/boxuan-zhao/matt-pocock/improve-codebase-architecture/SKILL.md | Adds workflow to produce an HTML architecture review report + follow-up grilling. |
| skills/boxuan-zhao/matt-pocock/improve-codebase-architecture/HTML-REPORT.md | Adds reference scaffold/patterns for the HTML architecture report. |
| skills/boxuan-zhao/matt-pocock/migrate-to-shoehorn/SKILL.md | Adds guidance for replacing TS as assertions in tests with shoehorn helpers. |
| skills/boxuan-zhao/matt-pocock/prototype/SKILL.md | Adds high-level prototyping workflow skill (logic vs UI branches). |
| skills/boxuan-zhao/matt-pocock/prototype/LOGIC.md | Adds reference for building logic/state-machine TUIs for prototyping. |
| skills/boxuan-zhao/matt-pocock/prototype/UI.md | Adds reference for building multi-variant UI prototypes. |
| skills/boxuan-zhao/matt-pocock/research/SKILL.md | Adds “research via primary sources” background-agent workflow skill. |
| skills/boxuan-zhao/matt-pocock/resolving-merge-conflicts/SKILL.md | Adds merge/rebase conflict resolution workflow skill. |
| skills/boxuan-zhao/matt-pocock/scaffold-exercises/SKILL.md | Adds skill to scaffold exercises that pass a specific lint workflow. |
| skills/boxuan-zhao/matt-pocock/setup-matt-pocock-skills/SKILL.md | Adds repo-configuration skill for issue tracker + labels + domain docs layout. |
| skills/boxuan-zhao/matt-pocock/setup-matt-pocock-skills/domain.md | Adds reference for how skills should consume domain docs/ADRs. |
| skills/boxuan-zhao/matt-pocock/setup-matt-pocock-skills/issue-tracker-github.md | Adds GitHub issue tracker workflow template/reference. |
| skills/boxuan-zhao/matt-pocock/setup-matt-pocock-skills/issue-tracker-gitlab.md | Adds GitLab issue tracker workflow template/reference. |
| skills/boxuan-zhao/matt-pocock/setup-matt-pocock-skills/issue-tracker-local.md | Adds local-markdown tracker conventions for issues/tickets/wayfinding. |
| skills/boxuan-zhao/matt-pocock/setup-matt-pocock-skills/triage-labels.md | Adds canonical→repo label mapping template for triage skills. |
| skills/boxuan-zhao/matt-pocock/setup-pre-commit/SKILL.md | Adds skill to set up Husky/lint-staged/Prettier pre-commit hooks. |
| skills/boxuan-zhao/matt-pocock/tdd/SKILL.md | Adds TDD reference skill (red-green-refactor + test quality rules). |
| skills/boxuan-zhao/matt-pocock/tdd/mocking.md | Adds reference guidance on when/how to mock in tests. |
| skills/boxuan-zhao/matt-pocock/tdd/tests.md | Adds examples contrasting good vs bad tests. |
| skills/boxuan-zhao/matt-pocock/teach/SKILL.md | Adds stateful teaching-workspace skill. |
| skills/boxuan-zhao/matt-pocock/teach/MISSION-FORMAT.md | Adds template for teaching workspace mission definition. |
| skills/boxuan-zhao/matt-pocock/teach/RESOURCES-FORMAT.md | Adds template for curated resources list. |
| skills/boxuan-zhao/matt-pocock/teach/LEARNING-RECORD-FORMAT.md | Adds template for learning record files. |
| skills/boxuan-zhao/matt-pocock/teach/GLOSSARY-FORMAT.md | Adds template for teaching workspace glossary. |
| skills/boxuan-zhao/matt-pocock/to-spec/SKILL.md | Adds skill to synthesize a spec from current conversation and publish it. |
| skills/boxuan-zhao/matt-pocock/to-tickets/SKILL.md | Adds skill to split work into vertical-slice tickets and publish them. |
| skills/boxuan-zhao/matt-pocock/triage/SKILL.md | Adds triage workflow skill for moving issues/PRs through triage states. |
| skills/boxuan-zhao/matt-pocock/triage/AGENT-BRIEF.md | Adds reference template/guidance for writing agent briefs. |
| skills/boxuan-zhao/matt-pocock/triage/OUT-OF-SCOPE.md | Adds reference guidance for maintaining .out-of-scope/ KB files. |
| skills/boxuan-zhao/matt-pocock/wayfinder/SKILL.md | Adds wayfinding workflow skill for multi-session “map + tickets” planning. |
| skills/boxuan-zhao/matt-pocock/writing-great-skills/SKILL.md | Adds reference skill for authoring predictable skills (principles/vocabulary). |
| skills/boxuan-zhao/matt-pocock/writing-great-skills/GLOSSARY.md | Adds glossary reference backing the writing-great-skills vocabulary. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| @@ -0,0 +1,7 @@ | |||
| --- | |||
| name: grill-with-docs | |||
| description: A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go. | |||
Comment on lines
+8
to
+11
| - Upstream commit: `391a2701dd948f94f56a39f7533f8eea9a859c87` | ||
| - Upstream date: 2026-07-10 | ||
| - License: MIT; see `LICENSE` | ||
| - Owner in this catalog: `boxuan-zhao` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Publishes the stable Matt Pocock engineering, productivity, and utility skill set under
skills/boxuan-zhao/.What changed
mattpocock/skillsat upstream commit391a2701dd948f94f56a39f7533f8eea9a859c87.skills/boxuan-zhao/LICENSE-MATT-POCOCK.deprecated,in-progress, andpersonalcategories.skills/shared/catalog.Purpose and impact
These skills provide a composable engineering workflow covering clarification, domain modeling, specification, ticket decomposition, implementation, TDD, debugging, architecture review, code review, research, and handoff. They are published in a contributor-owned namespace and are not proposed as team defaults in this PR.
Some skills may create or edit repository documentation, issue-tracker records, tests, implementation files, Git hooks, or reports when explicitly invoked. Their external dependencies vary by skill and are documented within the bundled
SKILL.mdand supporting files.Validation
python scripts/validate_skills.pynpx skills@latest add . --listgit diff --check