Skip to content

Add usethis-lesson-create skill with root cause analysis template#1801

Merged
nathanjmcdougall merged 2 commits into
mainfrom
copilot/create-lesson-template-root-cause-analysis
Apr 4, 2026
Merged

Add usethis-lesson-create skill with root cause analysis template#1801
nathanjmcdougall merged 2 commits into
mainfrom
copilot/create-lesson-template-root-cause-analysis

Conversation

Copilot AI commented Apr 4, 2026

Copy link
Copy Markdown
Contributor

The existing Lessons guidance in AGENTS.md was generic prose with no structure — agents had no template to follow and no prompt to dig past the symptom to an underlying cause.

New skill: usethis-lesson-create

Introduces .agents/skills/usethis-lesson-create/SKILL.md covering:

  • Why RCA matters — surface summaries don't prevent recurrence; a lesson must answer what, why, and what principle
  • 5 Whys procedure — iterative "why?" questioning with a worked example showing symptom → root cause → transferable principle
  • Lesson template — structured Markdown template with five sections: What happened · Root cause · Generalised principle · Resolution · Follow-up
  • Filing guidance — title the GitHub issue after the principle, not the symptom (e.g. agent: always run static checks after modifying AGENTS.md, not agent: forgot to update AGENTS.md)

Supporting changes

  • AGENTS.md Lessons section — replaces the freeform paragraph with a tighter directive referencing usethis-lesson-create
  • AGENTS.md skills registry — adds the new skill to the table
  • usethis-github-issue-create v1.1 — adds a cross-reference on the "record a lesson" bullet so agents are directed to structure the lesson first

Copilot AI changed the title [WIP] Add lesson template for root cause analysis skill Add usethis-lesson-create skill with root cause analysis template Apr 4, 2026
Copilot AI requested a review from nathanjmcdougall April 4, 2026 00:55
@nathanjmcdougall nathanjmcdougall marked this pull request as ready for review April 4, 2026 00:58
@nathanjmcdougall nathanjmcdougall merged commit 8bf63c0 into main Apr 4, 2026
1 check passed
@nathanjmcdougall nathanjmcdougall deleted the copilot/create-lesson-template-root-cause-analysis branch April 4, 2026 01:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Agent: Create a lesson template in a new root cause analysis skill

2 participants