Agent config: Record lessons as GitHub issues instead of directly editing skills (#1618)

Copilot · nathanjmcdougall · web-flow · commit 994bf68d967b · 2026-03-28T01:56:09.000+13:00
* Initial plan * Update Lessons section to record lessons as GitHub issues instead of editing skills Replace instruction to directly update/create skills with instruction to use the usethis-github-issue-create skill to record lessons as GitHub issues for triage. Resolves #1618 Agent-Logs-Url: https://github.com/usethis-python/usethis-python/sessions/8072bce1-d777-48a9-9e08-d22c2e9d0af4 Co-authored-by: nathanjmcdougall <18602289+nathanjmcdougall@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: nathanjmcdougall <18602289+nathanjmcdougall@users.noreply.github.com>
diff --git a/AGENTS.md b/AGENTS.md
@@ -254,4 +254,4 @@ External skills can be installed if they are not present — see the `usethis-sk
 
 ## Lessons
 
-When you are working on a problem, you are almost always going to encounter a difficulty. This is great - it's an opportunity for learning. ALWAYS make a note explicitly of what lessons you are drawing as you complete a task or when receiving user feedback. Try and keep this structured: consider the root cause of the difficulty, and how you overcame it. After finishing work on a task, report back all your lessons. Finally, try and update the relevant skills with any new insights you've drawn, to help future agents, and/or create a new skill.
+When you are working on a problem, you are almost always going to encounter a difficulty. This is great - it's an opportunity for learning. ALWAYS make a note explicitly of what lessons you are drawing as you complete a task or when receiving user feedback. Try and keep this structured: consider the root cause of the difficulty, and how you overcame it. After finishing work on a task, report back all your lessons. Finally, ALWAYS use the `usethis-github-issue-create` skill to record each lesson as a GitHub issue so it can be triaged and tracked.

Original file line number	Diff line number	Diff line change
@@ -254,4 +254,4 @@ External skills can be installed if they are not present — see the `usethis-sk
`254`	`254`
`255`	`255`	`## Lessons`
`256`	`256`
`257`		-When you are working on a problem, you are almost always going to encounter a difficulty. This is great - it's an opportunity for learning. ALWAYS make a note explicitly of what lessons you are drawing as you complete a task or when receiving user feedback. Try and keep this structured: consider the root cause of the difficulty, and how you overcame it. After finishing work on a task, report back all your lessons. Finally, try and update the relevant skills with any new insights you've drawn, to help future agents, and/or create a new skill.
	`257`	+When you are working on a problem, you are almost always going to encounter a difficulty. This is great - it's an opportunity for learning. ALWAYS make a note explicitly of what lessons you are drawing as you complete a task or when receiving user feedback. Try and keep this structured: consider the root cause of the difficulty, and how you overcame it. After finishing work on a task, report back all your lessons. Finally, ALWAYS use the `usethis-github-issue-create` skill to record each lesson as a GitHub issue so it can be triaged and tracked.