Commit graph

174 commits

Author SHA1 Message Date
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
Matt Pocock
e74f0061bb Clarify purpose of CONTEXT.md to emphasize it as a glossary, removing implementation details 2026-05-13 14:05:18 +01:00
Matt Pocock
f304057d61 Fix typo in prototype skill description for clarity 2026-05-12 08:36:19 +01:00
Matt Pocock
9f2e0bd0ea Enhance writing-fragments skill to capture initial user prompts as fragments 2026-05-11 10:19:41 +01:00
Matt Pocock
b6250ed602 Add 'handoff' skill to improve workflow documentation and agent transitions 2026-05-11 09:13:01 +01:00