Matt Pocock
47bde84da0
feat: introduce new skills and refine existing ones
...
- Add `ask-matt` skill for user-invoked routing.
- Introduce `codebase-design` and `domain-modeling` skills, updating dependencies.
- Remove unused `caveman` and `zoom-out` skills.
- Rename `diagnose` skill to `diagnosing-bugs`.
- Add `resolving-merge-conflicts` skill for handling git conflicts.
- Tighten `review` skill with improved checks.
- Update skill taxonomy to user-invoked and model-invoked.
- Replace `write-a-skill` with `writing-great-skills` for better guidance.
2026-06-17 15:39:06 +01:00
Matt Pocock
6a62d72ab1
Merge pull request #291 from mattpocock/matt/commands-and-skills
...
Split skills into model-invoked vs user-invoked
2026-06-17 15:21:40 +01:00
Matt Pocock
a032401486
chore: set up changesets
...
Add changesets for tracking and versioning skill changes:
- package.json (private) + @changesets/cli and @changesets/changelog-github
- .changeset/config.json using the GitHub release-style changelog
- release workflow that opens a version PR on push to main (no npm publish)
- initial changeset recording recent skill updates
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 15:21:20 +01:00
Matt Pocock
ee8bae4006
Reduced description lengths
2026-06-17 15:15:11 +01:00
Matt Pocock
460f19f240
refine: Simplify description in 'ask-matt' skill documentation
2026-06-17 14:57:25 +01:00
Matt Pocock
245e31bbbd
refine: Remove 'caveman' skill and update documentation accordingly
2026-06-17 14:56:08 +01:00
Matt Pocock
48f3d31fef
refine: Clarify multi-session build process and enhance triage guidance in 'ask-matt' skill documentation
2026-06-17 14:53:11 +01:00
Matt Pocock
df129fcfce
refine: Add 'ask-matt' skill and update documentation for user-invoked skills
2026-06-17 14:45:47 +01:00
Matt Pocock
aa7ed40cbe
refine: Make writing-great-skills hunt no-ops at the sentence level
...
Add a Pruning directive to run the no-op test sentence by sentence and
delete whole failing sentences rather than trim words. References the
existing no-op test as single source of truth — no restated definition.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 14:33:42 +01:00
Matt Pocock
2e647324f9
refine: Tighten review skill — fail-fast ref check, single-sourced rules, no-op cuts
...
- Validate the fixed point resolves and diff is non-empty before spawning sub-agents
- Single-source the tooling-enforced and two-axis rationale (point to Why two axes)
- Fix rerank contradiction: summarize worst issue per axis, not across axes
- Drop dead "Read X, then read the diff" preambles from both briefs
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 14:29:34 +01:00
Matt Pocock
e112a6b03c
Remove zoom-out skill and all references
...
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 14:19:52 +01:00
Matt Pocock
801a01cc7d
refine: Update terminology from Commands/Skills to User-invoked/Model-invoked and enhance documentation
2026-06-17 14:18:05 +01:00
Matt Pocock
bc4cf903ff
Added writing-great-skills skill
2026-06-17 13:45:28 +01:00
Matt Pocock
ab7196a158
feat: Add decision-mapping skill
...
Adds a new engineering skill that turns loose ideas with many
interdependent open decisions into a sequenced DAG of one-session
investigation tickets, driving them to resolution one at a time.
Sits at the front of the pipeline, before /to-prd.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 13:30:21 +01:00
Matt Pocock
ffb2fa6623
feat: Add implement skill documentation for PRD-based work
2026-06-12 09:25:19 +01:00
Matt Pocock
788b5c382b
Added prefactoring
2026-06-12 09:25:19 +01:00
Matt Pocock
81ddacb08b
refine: Add skill documentation for resolving merge conflicts
2026-06-12 09:25:19 +01:00
Matt Pocock
3832253f14
The fewer seams, the better
2026-06-12 09:25:19 +01:00
Matt Pocock
658d53e6de
Improved /grill-with-docs commit message
2026-06-12 09:25:19 +01:00
Matt Pocock
800201f7b2
refine: Update description for grilling skill to enhance clarity and focus
2026-06-12 09:25:19 +01:00
Matt Pocock
0a8105bba9
refine: Remove caveman skill documentation to streamline productivity skills
2026-06-12 09:25:19 +01:00
Matt Pocock
7d3ada9716
refine: Remove caveman skill documentation to streamline productivity skills
2026-06-12 09:25:19 +01:00
Matt Pocock
0a4b76776d
refine: Add disable-model-invocation flag to edit-article skill for improved functionality
2026-06-12 09:25:19 +01:00
Matt Pocock
cbf6db4233
refine: Update description for grill-me skill and adjust session instruction for clarity
2026-06-12 09:25:19 +01:00
Matt Pocock
2064fb64bc
refine: Simplify instructions for running grilling and domain modeling skills
2026-06-12 09:25:19 +01:00
Matt Pocock
221ffca967
feat: Add new skills and templates for domain modeling, bug diagnosis, and architectural improvement
...
- Introduced a human-in-the-loop script for bug diagnosis to capture user feedback.
- Created ADR and CONTEXT formats to standardize architectural decision records and domain context documentation.
- Developed a domain modeling skill to refine terminology and maintain a shared language.
- Enhanced the improve-codebase-architecture skill to provide visual reports and deepening opportunities.
- Consolidated grilling and handoff skills for better user interaction and documentation.
- Updated existing skills to improve clarity and consistency in descriptions and functionality.
2026-06-12 09:25:19 +01:00
Matt Pocock
694fa30311
Refine quiz guidelines by standardizing answer length to prevent user clues and enhance assessment integrity.
2026-06-10 16:01:44 +01:00
Matt Pocock
dabb725dfd
Clarify terminology in teaching documentation by replacing 'learner' with 'user' for consistency and improved user experience.
2026-06-10 15:53:12 +01:00
Matt Pocock
3b37863fc3
Enhance teaching guidelines by introducing concepts of fluency vs storage strength, emphasizing long-term retention strategies, and adding reminders for follow-up questions to improve learner engagement.
2026-06-10 15:52:32 +01:00
Matt Pocock
d75217795c
Refine lesson guidelines for clarity and user experience by emphasizing brevity and actionable outcomes
2026-06-10 14:32:02 +01:00
Matt Pocock
26ba8ae34b
Add recommendation for primary source in lesson guidelines to enhance resource quality
2026-06-10 14:12:04 +01:00
Matt Pocock
e3d8b735ef
Add HTML anchor linking between lessons and reference documents for improved navigation
2026-06-09 18:56:43 +01:00
Matt Pocock
59c92aa9e7
Clarify mission updates in teaching documentation to ensure alignment with user skill development
2026-06-09 18:56:13 +01:00
Matt Pocock
2bf7005192
Add teaching skill and related documentation for enhanced learning experience
2026-06-08 15:02:04 +01:00
Matt Pocock
be55a79703
Add NOTES.md for recording user preferences and teaching notes
2026-06-06 10:12:27 +01:00
Matt Pocock
dbcb1bda03
Enhance lesson guidelines by emphasizing the importance of citations and interactive elements for improved user engagement
2026-06-06 10:10:38 +01:00
Matt Pocock
cef541c888
Merge branch 'main' of github.com:mattpocock/skills
...
# Conflicts:
# skills/in-progress/teach/SKILL.md
2026-06-06 10:09:36 +01:00
Matt Pocock
88eb3f8d04
Refactor teaching documentation to enhance clarity and structure; added lessons section and improved terminology consistency.
2026-06-06 10:06:03 +01:00
Matt Pocock
aaf2453fbd
Refine teaching skill documentation to enhance clarity and interactivity of explainers
2026-05-31 10:08:36 +01:00
Matt Pocock
e3b90b5238
Refine rules in CONTEXT-FORMAT.md for clarity and consistency
2026-05-28 16:48:30 +01:00
Matt Pocock
0288510dd6
Merge branch 'main' of github.com:mattpocock/skills
2026-05-27 13:36:22 +01:00
Matt Pocock
bd96a9f0c6
Moved /teach to in-progress
2026-05-27 13:36:16 +01:00
Matt Pocock
fadf11d45f
Added /teach
2026-05-27 13:35:56 +01:00
Matt Pocock
b8be62ffac
Merge branch 'main' of https://github.com/mattpocock/skills
2026-05-20 09:46:53 +01:00
Matt Pocock
a36584e09e
Updated ICA
2026-05-20 09:46:51 +01:00
Matt Pocock
d54c497aa9
Improved wording of /handoff
2026-05-19 17:07:02 +01:00
Matt Pocock
e7df78bb81
Removed relationships, example dialogue, and flagged ambiguities from CONTEXT.md template
2026-05-19 14:40:27 +01:00
Matt Pocock
bc32841b2e
Update handoff skill documentation to clarify saving location for handoff documents
2026-05-19 14:34:59 +01:00
Matt Pocock
feaaf4204d
Added redaction info to handoff skill
2026-05-19 14:29:31 +01:00
Matt Pocock
67bce91c80
Fix typo in README.md regarding ticket labels
2026-05-18 13:21:28 +01:00
