Skip to content
Back to search

upskill-me

MarketplaceWorks with Claude CodeGitHub

Agent skills that teach you while you do real engineering work.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wojukasz--upskill-me/badge.svg)](/listings/wojukasz--upskill-me)

HTML

<a href="/listings/wojukasz--upskill-me"><img src="/api/listings/wojukasz--upskill-me/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code**, as a plugin:

claude plugin marketplace add wojukasz/upskill-me
claude plugin install upskill-me@upskill-me

**Any agent that reads [Agent Skills](https://agentskills.io)**, with the [skills CLI](https://www.skills.sh):

npx skills add wojukasz/upskill-me

**oh-my-pi**:

omp plugin marketplace add wojukasz/upskill-me
omp plugin install upskill-me@upskill-me

**By hand**: clone the repository and link each folder under `skills/` into your agent's skills directory, for example `~/.claude/skills` or `~/.agents/skills`.

git clone https://github.com/wojukasz/upskill-me ~/git/upskill-me
for s in ~/git/upskill-me/skills/*/; do ln -s "$s" ~/.claude/skills/; done

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 22 lines
  1. {
  2. "name": "upskill-me",
  3. "owner": {
  4. "name": "Lukasz Wojnicki",
  5. "url": "https://github.com/wojukasz"
  6. },
  7. "description": "Agent skills that teach you while you do real engineering work.",
  8. "plugins": [
  9. {
  10. "name": "upskill-me",
  11. "source": "./",
  12. "description": "coach-me, tutor-me and explain-change-me: learn while the agent helps, instead of only reading finished answers.",
  13. "category": "learning",
  14. "keywords": [
  15. "learning",
  16. "coaching",
  17. "tutor",
  18. "sre"
  19. ]
  20. }
  21. ]
  22. }
README.md · README · 181 lines
  1. # upskill-me
  2. Three agent skills that teach you while you do real engineering work.
  3. Coding agents are good at handing you finished answers. That gets the ticket
  4. closed and leaves you no better at the job: you forget the command, cannot
  5. explain the change in review, and ask again next week. These skills change
  6. what the agent hands back, so the work still gets done and you learn from it.
  7. | Skill | Who does the work | You get | Pick it when |
  8. |---|---|---|---|
  9. | [`coach-me`](skills/coach-me/SKILL.md) | You | Hints and questions, one at a time, never the solution | You are doing the task and want to work it out yourself |
  10. | [`tutor-me`](skills/tutor-me/SKILL.md) | You run it; the agent answers | The answer, how it works, the commands for you to type, how to find it next time | It has to be done today and you want to understand it |
  11. | [`explain-change-me`](skills/explain-change-me/SKILL.md) | The agent, before anything changes | The mechanism, the settings, blast radius, rollback, a paragraph for colleagues | The change is unfamiliar or hard to undo, or you must defend it |
  12. They are written for infrastructure and software engineers: the examples lean
  13. towards Kubernetes, Terraform, Grafana, Go and Python, but the methods work for
  14. any stack.
  15. ## Which one?
  16. ```mermaid
  17. flowchart TD
  18. A{Is a change about to be made<br/>to something unfamiliar or hard to undo?} -->|yes| E[explain-change-me]
  19. A -->|no| B{Do you want to write it yourself?}
  20. B -->|yes| C[coach-me]
  21. B -->|no, it has to be done now| T[tutor-me]
  22. C -.->|stuck, need it done| T
  23. T -.->|want to try it yourself| C
  24. ```
  25. The skills hand over to each other: `coach-me` offers `tutor-me` when you ask
  26. for the answer, `tutor-me` switches to `coach-me` when you want to write it
  27. yourself, and both use `explain-change-me` for the full path of a mechanism.
  28. ### Examples
  29. | Situation | Skill |
  30. |---|---|
  31. | Writing your first Helm chart and you want the practice | `/coach-me write a Helm chart for the API` |
  32. | A failing test you want to debug yourself | `/coach-me` (troubleshoot mode) |
  33. | Reviewing a colleague's Terraform MR and you want to spot what a lead would | `/coach-me review` |
  34. | Fixing a production autoscaler today and you want to know why the fix works | `/tutor-me` |
  35. | Changing node consolidation, and you must explain it in the change review | `explain-change-me` |
  36. ## Skills that complete the set
  37. upskill-me covers learning while you do one task. These skills from other
  38. repositories cover the rest, and the three here are written to work beside
  39. them. They are not bundled: install the ones you want from their own repos.
  40. | Skill | From | What it adds | Use it when |
  41. |---|---|---|---|
  42. | `show-me` | [humanlayer/skills](https://github.com/humanlayer/skills) | Pseudocode, call trees, file trees, Mermaid diagrams and focused HTML visuals | Prose is not landing. `coach-me` and `tutor-me` ask for "a diagram" when the flow needs one; this is the skill that draws it |
  43. | `teach` | [mattpocock/skills](https://github.com/mattpocock/skills) | A lesson track over weeks: a mission, short HTML lessons with quizzes, reference sheets and numbered learning records | You want to learn a topic for its own sake, not just get through today's task |
  44. | `wait-what` | [mattpocock/skills](https://github.com/mattpocock/skills) | The last answer again, re-pitched in simpler or glossary terms | An explanation from any skill did not land |
  45. | `grill-me` | [mattpocock/skills](https://github.com/mattpocock/skills) | A relentless interview about a plan, one question at a time, each with a recommended answer | Before `explain-change-me`: settle what you are changing and why, then learn how it works |
  46. How they fit together:
  47. ```mermaid
  48. flowchart LR
  49. G[grill-me<br/>what and why] --> E[explain-change-me<br/>how it works]
  50. E --> C[coach-me / tutor-me<br/>do the work]
  51. C -.->|need a picture| S[show-me]
  52. C -.->|lost| W[wait-what]
  53. C -.->|want the whole topic| T[teach]
  54. ```
  55. Install them with the [skills CLI](https://www.skills.sh), one skill at a time:
  56. ```sh
  57. npx skills add humanlayer/skills --skill show-me
  58. npx skills add mattpocock/skills --skill teach
  59. npx skills add mattpocock/skills --skill wait-what
  60. npx skills add mattpocock/skills --skill grill-me
  61. ```
  62. Or, in Claude Code, from their plugin marketplaces:
  63. ```sh
  64. claude plugin marketplace add humanlayer/skills
  65. claude plugin install show-me@skills
  66. claude plugin marketplace add mattpocock/skills
  67. claude plugin install mattpocock-skills@mattpocock
  68. ```
  69. Matt Pocock's plugin installs his whole engineering set, not only the three
  70. above.
  71. ## What each skill does
  72. **`coach-me`** classifies the request into one of nine modes (mechanism,
  73. build, practice, troubleshoot, read, review, design, recall, explain) and
  74. coaches with the smallest useful help: a question, then where to look, then
  75. the concept by name, then an approach, then pseudocode. It does not write the
  76. solution or edit your files. It finishes by asking you to explain why the
  77. result works, with two quiz questions and primary sources to read next.
  78. **`tutor-me`** gives the real answer in a fixed shape: what we are doing and
  79. what good looks like, how it works underneath, the commands for you to run
  80. (read-only first, with the undo for anything that changes state), and how to
  81. look it up yourself next time. It asks for one prediction per reply and ends a
  82. task with a recap and two quiz questions.
  83. **`explain-change-me`** walks through a change before it is made: the
  84. paragraph for colleagues, how the surrounding system works, the knobs and
  85. their defaults, which layer enforces what, what happens at runtime, blast
  86. radius, what a rollback does and does not undo, and the read-only commands
  87. that show it.
  88. `coach-me` and `tutor-me` are started by hand (`/coach-me`, `/tutor-me`).
  89. `explain-change-me` is also picked up by the agent on its own when a change
  90. touches a system you did not build or is hard to reverse.
  91. ## Install
  92. **Claude Code**, as a plugin:
  93. ```sh
  94. claude plugin marketplace add wojukasz/upskill-me
  95. claude plugin install upskill-me@upskill-me
  96. ```
  97. **Any agent that reads [Agent Skills](https://agentskills.io)**, with the
  98. [skills CLI](https://www.skills.sh):
  99. ```sh
  100. npx skills add wojukasz/upskill-me
  101. ```
  102. **oh-my-pi**:
  103. ```sh
  104. omp plugin marketplace add wojukasz/upskill-me
  105. omp plugin install upskill-me@upskill-me
  106. ```
  107. **By hand**: clone the repository and link each folder under `skills/` into
  108. your agent's skills directory, for example `~/.claude/skills` or
  109. `~/.agents/skills`.
  110. ```sh
  111. git clone https://github.com/wojukasz/upskill-me ~/git/upskill-me
  112. for s in ~/git/upskill-me/skills/*/; do ln -s "$s" ~/.claude/skills/; done
  113. ```
  114. ## Make it yours
  115. All three skills read `~/.config/upskill-me/profile.md` before they start, if
  116. it exists: what you work with daily, what you are learning, and what to skip.
  117. Without it, the skill asks you once. Start from
  118. [`examples/profile.md`](examples/profile.md):
  119. ```sh
  120. mkdir -p ~/.config/upskill-me
  121. cp examples/profile.md ~/.config/upskill-me/profile.md
  122. ```
  123. Your own agent instructions (`AGENTS.md`, `CLAUDE.md`) still win on accuracy,
  124. writing style and safety: the skills never change a live system without your
  125. say-so.
  126. ## Compatibility
  127. The skills follow the [Agent Skills specification](https://agentskills.io/specification).
  128. `coach-me` and `tutor-me` also set `disable-model-invocation` and
  129. `argument-hint`, which Claude Code and oh-my-pi use to run them only when you
  130. type the command. Agents that ignore those fields may start them on their own;
  131. the descriptions say "invoked by hand" to discourage that.
  132. Check a skill against the specification (the two extra fields above are
  133. reported and expected):
  134. ```sh
  135. uvx --from skills-ref agentskills validate skills/explain-change-me
  136. ```
  137. ## Licence
  138. [MIT](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.