edkuksa/skills
1
0
Fork 0
mirror of https://github.com/mattpocock/skills.git synced 2026-07-29 02:52:42 +07:00
Code Issues Packages Projects Releases Wiki Activity
130 Commits 64 Branches 4 Tags
00ff03cac21a8a845b06256d826d183122f58c5e
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
Matt PocockandGitHub 00ff03cac2 Merge pull request #345 from mattpocock/changeset-release/main 
chore: version skills
 2026-06-17 15:40:47 +01: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 PocockandGitHub 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 PocockandClaude Opus 4.8 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 PocockandClaude Opus 4.8 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 PocockandClaude Opus 4.8 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 PocockandClaude Opus 4.8 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 PocockandClaude Opus 4.8 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 PocockandGitHub 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
Matt Pocock 9fecab929a Add review skill to facilitate two-axis code reviews 2026-05-10 20:59:48 +01:00
Matt Pocock 733d312884 Add skills.sh badge to README for visibility 2026-05-07 07:34:11 +01:00
Matt Pocock 3bb0b1b917 Update issue listing command in GitLab documentation for clarity 2026-05-07 07:20:57 +01:00
Matt Pocock 70141119e9 Update triage label in PRD writing instructions to 'ready-for-agent' 2026-05-06 16:07:58 +01:00
Matt Pocock 494e4b2699 Exclude deprecated skills from linking in the link-skills script 2026-05-06 14:22:15 +01:00
Matt Pocock 918f3fe30f Add instruction to read the handoff file before writing to it 2026-05-06 13:40:13 +01:00
Matt Pocock c8364b0d1f Add suggestion for skills to be used in next session in handoff documentation 2026-05-06 12:56:32 +01:00
Matt Pocock c63fd971a7 Remove disable-model-invocation flag from handoff skill documentation 2026-05-06 12:53:07 +01:00
Matt Pocock b27a1a46f8 Add handoff skill documentation for agent transition 2026-05-06 09:33:40 +01:00
Matt Pocock ff3ee1dda5 Add prototype skill and related documentation for interactive design exploration 2026-05-06 09:26:48 +01:00
Matt Pocock e736396b35 Clarify issue publication instructions for AFK agents in SKILL.md 2026-05-06 07:40:30 +01:00
Matt PocockandCopilot b843cb5ea7 Add structured sections for 'what-to-do' and 'supporting-info' in SKILL.md 
Co-authored-by: Copilot <copilot@github.com>
 2026-04-30 12:38:11 +01:00
Matt Pocock 839025ae17 Remove disable-model-invocation flag from grill-with-docs 2026-04-30 11:46:00 +01:00
Matt Pocock 3dae2b1945 Add verify/check mode documentation and list-skills script 2026-04-30 10:12:35 +01:00
Matt PocockandClaude Opus 4.7 f71bb975bf Add out-of-scope note: issue trackers must be mainstream 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-29 10:56:28 +01:00
Matt PocockandClaude Opus 4.7 4369256220 Add GitLab as a first-class issue-tracker option 
Closes #98

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-29 08:21:19 +01:00
Matt PocockandClaude Opus 4.7 b56795bed1 Add out-of-scope note for grilling question limits 
Records the rejection of #44 (request for a hard cap on grilling
questions) so the reasoning isn't lost when the issue is closed and so
future similar requests can be deduplicated against it.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-28 19:25:12 +01:00
Matt PocockandCopilot 179a14e721 Swapped 'backlog' for 'issue tracker 
Co-authored-by: Copilot <copilot@github.com>
 2026-04-28 19:06:32 +01:00
Matt Pocock 5fed805a92 Enhance quickstart instructions in README; clarify setup steps for /setup-matt-pocock-skills and triage labels 2026-04-28 16:51:49 +01:00
Matt PocockandGitHub 0e51243253 Merge pull request #90 from mattpocock/setup-skill-and-vague-prose 
Add setup-matt-pocock-skills; rename github-triage; migrate skills to vague prose
 2026-04-28 16:46:49 +01:00
Matt Pocock 70653e105c Enhance user guidance in setup-matt-pocock-skills; add explanations for backlog backend, triage labels, and domain docs decisions 2026-04-28 16:41:14 +01:00
Matt Pocock a32ebfb550 Remove deprecated triage-issue skill and update README to reflect changes 2026-04-28 16:35:22 +01:00
Matt PocockandClaude Opus 4.7 7afa86d3a5 Add setup-matt-pocock-skills; rename github-triage to triage; migrate engineering skills to vague prose 
Engineering skills no longer hard-code GitHub or specific label strings.
A new setup skill scaffolds an `## Agent skills` block in
AGENTS.md/CLAUDE.md plus `docs/agents/` so each repo can declare its own
backlog backend, triage label vocabulary, and domain doc layout. Skills
that need the mapping (to-issues, to-prd, triage) point at the setup
skill; skills that only soften with it (diagnose, tdd,
improve-codebase-architecture, zoom-out) stay vague. ADR-0001 records
the split.

Closes #88, #89.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-28 16:33:37 +01:00
Matt PocockandGitHub 49cec7be01 Update title in README.md 2026-04-28 14:42:04 +01:00
Matt PocockandGitHub d7c8dcfd02 Enhance README with skills newsletter images 
Added images for skills newsletter in README.
 2026-04-28 14:40:16 +01:00
Matt Pocock 073a37e75d Enhance link-skills.sh to check for symlink conflicts and provide user guidance 2026-04-28 12:38:36 +01:00
Matt Pocock f76e3ba4af Add DOMAIN-AWARENESS.md and update SKILL.md files to reference it for code exploration 2026-04-28 12:04:01 +01:00
Matt Pocock ecdadb4076 Refine README to improve clarity and conciseness in the explanation of agent communication challenges and solutions 2026-04-28 11:21:32 +01:00
Matt Pocock 20861cb0a1 Enhance README by adding links to skill documentation and clarifying the purpose of feedback loops in AI development 2026-04-28 11:20:15 +01:00
Matt Pocock c21cf6ec93 Fix grammatical errors and enhance clarity in README section on agent skills 2026-04-28 10:55:14 +01:00
Matt Pocock 1eed8a689b Enhance README with detailed explanations of common AI failure modes and solutions 2026-04-28 10:50:40 +01:00
Matt Pocock edd9893326 Remove installation commands for individual skills from README 2026-04-28 10:19:48 +01:00
Matt Pocock 3911642d96 Add quickstart setup instructions to README 2026-04-28 10:18:47 +01:00
Matt Pocock fb847c6ade Refactor skill references and documentation for grill-with-docs skill 
- Updated skill reference from domain-model to grill-with-docs in plugin.json and README.md
- Added detailed descriptions and context for grill-with-docs in its SKILL.md
- Created ADR-FORMAT.md and CONTEXT-FORMAT.md for grill-with-docs to standardize decision recording
- Adjusted references in improve-codebase-architecture to align with new grill-with-docs structure
 2026-04-28 10:17:37 +01:00
Matt Pocock 51384f4e70 Remove deprecated skills from plugin.json 2026-04-28 10:11:06 +01:00
Matt Pocock 71542f9d1c Update skill references in README files and add new skills to deprecated and personal sections 2026-04-28 09:44:54 +01:00
Matt Pocock 62f43a1817 Add new skills for TDD, issue management, PRD creation, and productivity tools 
- Introduced TDD skills including deep modules, interface design, mocking, refactoring, and testing guidelines.
- Added skills for breaking plans into GitHub issues and creating PRDs from conversation context.
- Implemented productivity skills for scaffolding exercises, setting up pre-commit hooks, and managing notes in Obsidian.
- Created a caveman communication mode for concise technical responses and a grilling technique for thorough plan discussions.
- Developed a skill for writing new agent skills with structured templates and guidelines.
- Included git guardrails to prevent dangerous git commands and a migration guide for using @total-typescript/shoehorn in tests.
 2026-04-28 09:42:34 +01:00
Matt PocockandCopilot 3e3ca9b9fa Add initial implementation of design-an-interface skill and linking script 
Co-authored-by: Copilot <copilot@github.com>
 2026-04-28 09:23:06 +01:00
Matt Pocock 383b6a06d5 Moved to ./skills directory 2026-04-28 08:00:37 +01:00
Matt Pocock e7f0b58a4b Added diagnose 2026-04-28 07:58:41 +01:00
Matt Pocock 90ea8eec03 Revise README.md to clarify the purpose of agent skills and promote newsletter subscription 2026-04-26 20:49:06 +01:00
Matt Pocock 77b06d1022 Update definition of 'Order' in CONTEXT-FORMAT.md for clarity and consistency 2026-04-26 20:47:17 +01:00
Matt Pocock 60aa99c023 Enhance documentation in DEEPENING.md and INTERFACE-DESIGN.md for clarity and consistency; introduce LANGUAGE.md for shared vocabulary in architectural discussions. 2026-04-24 20:26:50 +01:00
Matt Pocock 949472a791 Added DDD-awareness to improve-codebase-architecture 2026-04-23 11:25:36 +01:00
Matt Pocock 651eab033b Add agent brief and out-of-scope documentation for GitHub issue triage 2026-04-01 12:57:15 +01:00