Commit graph

118 commits

Author SHA1 Message Date
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 Pocock
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 Pocock
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 Pocock
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 Pocock
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 Pocock
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 Pocock
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 Pocock
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 Pocock
49cec7be01
Update title in README.md 2026-04-28 14:42:04 +01:00
Matt Pocock
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 Pocock
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
Test
1186cf6d42 Update terminology in SKILL.md: replace 'grilling session' with '/domain-model session' for consistency 2026-04-22 16:58:03 +01:00
Test
c2225f9865 Refine description in SKILL.md for clarity and conciseness 2026-04-22 12:10:22 +01:00
Test
3e251ea792 Clarify guidance on CONTEXT.md updates: emphasize meaningful terms for domain experts and avoid coupling to implementation details. 2026-04-22 12:10:11 +01:00
Test
8868f54212 Rename skills for clarity: update 'write-a-prd' to 'to-prd' and 'prd-to-issues' to 'to-issues' in README.md 2026-04-17 13:11:41 +01:00
Test
aaf3050857 Updated write-a-prd to to-prd 2026-04-17 13:10:02 +01:00
Test
a77fa6e7a6 Remove prd-to-plan skill
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-17 13:02:21 +01:00
Test
ab45d5e6e1 Added domain-model, updates to github-triage, and caveman 2026-04-17 10:36:26 +01:00
Test
1f25956a56 Add AI disclaimer requirement for GitHub issue comments 2026-04-15 06:17:41 +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
Matt Pocock
eebfb3c99a Refactor glossary tables and enhance example dialogue in Ubiquitous Language skill 2026-03-26 19:57:24 +00:00
Matt Pocock
98fecc7619 Merge branch 'main' of https://github.com/mattpocock/skills 2026-03-26 19:57:17 +00:00
Matt Pocock
a6bdfd9fed
Add instruction to ask questions one at a time 2026-03-26 14:28:04 +00:00