Commit graph

244 commits

Author SHA1 Message Date
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
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 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