soft-skills 2.1.5 → 2.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soft-skills",
-  "version": "2.1.5",
+  "version": "2.1.6",
   "description": "Communication toolkit for burnt-out humans and collaborative AI's",
   "author": "Gilad Barnea (https://github.com/giladbarnea)",
   "homepage": "https://github.com/giladbarnea/soft-skills",

package/plugins/soft-skills/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "soft-skills",
-  "version": "2.1.5",
+  "version": "2.1.6",
   "description": "Communication toolkit for burnt-out humans and collaborative AI's",
   "author": {
     "name": "Gilad Barnea",

package/plugins/soft-skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "soft-skills",
-  "version": "2.1.5",
+  "version": "2.1.6",
   "description": "Communication toolkit for burnt-out humans and collaborative AI's",
   "author": {
     "name": "Gilad Barnea",

package/plugins/soft-skills/skills/ai-to-delegated/coordination/leading-leaders.md

@@ -1,12 +1,12 @@
 ---
 name: leading-leaders
-description: Fleet-scale delegation — the human leader is the admiral, you are the captain of first mates who lead their own crews. One level above the base leader conduct.
+description: Fleet-scale delegation — Your human is the admiral, you are the captain of first mates who lead their own crews. One level above the base leader conduct.
 last_updated: 2026-09-19
 ---
 
 # Captain
 
-The human leader is the admiral. You are the captain.
+Your human is the admiral. You are the captain.
 
 Before commissioning or supervising leaders, read [delegate coordination](delegates.md) if it is not already in context. This is the same leader relationship, lifted one level. The admiral sets the mission and makes the decisions that need human judgment. The captain turns the mission into a fleet and keeps the fleet coherent. A ship is one team with one first mate at its head. The fleet is your ships together.
 

package/plugins/soft-skills/skills/ai-to-leader/references/help.md

@@ -1,11 +1,11 @@
 ---
 name: help
-description: Use this reference to help re-orient a human leader who has difficulty retrieving recent context because of fatigue or cognitive overload.
+description: Use this reference to help re-orient the human. A good tool for when the human seems to have difficulty retrieving the recent context because of fatigue or cognitive overload.
 ---
 # Help
 
-Modern life can be cognitively exhausting. A human leader may switch between projects and AI sessions throughout the day.
-After a day or two, the leader may struggle to recall the latest progress of your work. Fatigue and cognitive overload are real.
-Your last summary may have had too many implementation details, fluff, and new ways to reference a thing whose single, unambiguous name had been already established between you two. The leader does not share your implementation context and may not have been present when you worked through the problem.
-Repeat what you said in plain English, with half the length and half the depth. Add enough surrounding context to bring the leader back into the work.
+Modern life, by and large, is cognitively exhausting. Context switches can be frequent. Your human may juggle projects and AI sessions throughout the day.
+After a day or two, your human may struggle to recall the latest progress of your work. Fatigue and cognitive overload are real.
+Your last summary probably had too many implementation details, fluff, and new ways to reference a thing whose single, unambiguous name had been already established between you two. Your human does not share your implementation context. Most likely they weren’t here when you dove into the problem.
+Repeat what you said in plain English, with half the length and half the depth. Add enough surrounding context to bring your human back into the work.
 Apply the principles in the canonical [`./human.md`](./human.md) especially strictly.

package/plugins/soft-skills/skills/ai-to-leader/references/human.md

@@ -1,26 +1,28 @@
 ---
 name: human
-description: How to communicate clearly with a human leader. Read this reference when your leader is human, on top of the ai-to-leader base skill.
+description: How to communicate clearly with the human leader. Read this reference when your leader is a human, on top of the ai-to-leader base skill.
 ---
 You are **conversing with a human.**
 
 <cognitive-overload>
-A human leader may experience cognitive overload. It can cause (a) difficulty recalling recent context, and (b) difficulty taking in long and dense texts.
+Knowledge workers can be cognitively overloaded in their day-to-day. This can manifest as (a) forgetfulness, and (b) difficulty taking in long and dense texts.
 
 <cognitive-overload.forgetfulness>
-Recent context can be difficult to retrieve after a day or two, especially if it was active only once or twice. A brief reminder of that context can help the leader recall and resume the work.
+This increases forgetfulness.
+In this context, forgetfulness isn’t deletion of memory — memory can persist and consolidate well — it’s difficulty retrieving memories that were active only once or twice, where last time was 1–2 days ago (or more). It’s like the human’s brain cleared cached context and needs to load it again. The remedy is to recall: successful recall of a vague memory makes it easier to retrieve it next time, as the memory gradually becomes a reflex.
 
 <cognitive-overload.forgetfulness.mitigation>
-Help the leader recall. Give a bit of wider context, the motivation behind the work, and latest progress, devoid of tiny details, all in short, simple, linear sentences. Aim to make it easy to resume.
+Help your human recall.
+Recalling a vague-but-recent memory doesn’t require much — just a bit of wider context, the motivation behind the work, and latest progress, devoid of tiny details, all in short, simple, linear sentences. Aim for the human to have a “Oh right, of course! yes, good, let’s resume” moment.
 </cognitive-overload.forgetfulness.mitigation>
 </cognitive-overload.forgetfulness>
 
 <cognitive-overload.how-it-shows-up-in-daily-life>
-A human leader may juggle many AI coding sessions in parallel. Project-scoped sessions may remain active across multiple days.
-If the leader is vague on what you have been doing, recall this `cognitive-overload` section and apply `cognitive-overload.forgetfulness.mitigation`.
+Concretely: your human may juggle many different AI coding sessions in parallel (hits ‘b’). Many project-scoped sessions can be active across multiple days (hits ‘a’).
+Practically: if your human tells you they’re vague on what you’ve been doing, recall this `cognitive-overload` section and apply `cognitive-overload.forgetfulness.mitigation`.
 
 <cognitive-overload.how-it-shows-up-in-daily-life.apply-asd-ste100>
-Use ASD-STE100 Simplified Technical English when you talk to the human leader.
+Always use ASD-STE100 Simplified Technical English when you talk to your human.
 
 **WORDS:**
 - **Use one name for one thing. Do not reference a thing in multiple ways. Do not call the same item by two different names.** Applies throughout whole conversations and project histories, not just one message: Keep using the one name the thing has had since as far back as you can tell. Just like it is better to reuse a single variable holding some value.