Commit graph

142 commits

Author SHA1 Message Date
Matt Pocock
8370e760d0 refactor: enhance glossary clarity and structure 2026-06-24 11:29:44 +01:00
Matt Pocock
74f0450b9c Link skills into ~/.agents/skills as well as ~/.claude/skills
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 11:27:21 +01:00
Matt Pocock
c71fce0297 Refine decision-mapping bootstrap step
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 11:26:57 +01:00
Matt Pocock
e95b1813c5 Move loop-me into in-progress
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 11:26:57 +01:00
Matt Pocock
42396a51d6 fix: update ticket type terminology from "Discuss" to "Grilling" 2026-06-22 13:15:30 +01:00
Matt Pocock
6eeb81b5fc Merge branch 'main' of https://github.com/mattpocock/skills 2026-06-18 09:41:33 +01:00
Matt Pocock
e00eadb4bb Added PR's as a triage surface 2026-06-18 09:41:30 +01:00
Matt Pocock
2454c95dc3
Merge pull request #347 from mattpocock/changeset-release/main v1.0.1
chore: version skills
2026-06-17 23:07:39 +01:00
github-actions[bot]
7d684becad chore: version skills 2026-06-17 21:26:49 +00:00
Matt Pocock
aa024cb195 feat: enhance teach skill to prioritize reusable components from ./assets 2026-06-17 22:26:34 +01:00
Matt Pocock
d20ee2684e feat: let teach skill share code between lessons via ./assets
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 22:18:21 +01:00
Matt Pocock
bddb833cba fix: create GitHub releases on version bump v1.0.0
Add `publish: npx changeset tag` to the release workflow and enable
tagging for private packages in the changesets config, so merging a
Version PR creates a git tag and GitHub release.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 15:46:32 +01:00
Matt Pocock
00ff03cac2
Merge pull request #345 from mattpocock/changeset-release/main mattpocock-skills@1.0.0
chore: version skills
2026-06-17 15:40:47 +01:00
github-actions[bot]
82e85064ea chore: version skills 2026-06-17 14:39:42 +00:00
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