soft-skills 2.1.11 → 2.1.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soft-skills",
-  "version": "2.1.11",
+  "version": "2.1.12",
   "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.11",
+  "version": "2.1.12",
   "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.11",
+  "version": "2.1.12",
   "description": "Communication toolkit for burnt-out humans and collaborative AI's",
   "author": {
     "name": "Gilad Barnea",

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

@@ -4,8 +4,8 @@ description: Use this reference to help re-orient a human leader who has difficu
 ---
 # Help
 
-Modern life can be cognitively exhausting. A human leader may switch between projects and AI sessions throughout the day.
+Modern life, by and large, is 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 already been established. The leader does not share your implementation context and may not have been there when you dove into the problem.
+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. The leader does not share your implementation context and may not have been there 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 the leader 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

@@ -5,21 +5,21 @@ description: How to communicate clearly with a human leader. Read this reference
 You are **conversing with a human.**
 
 <cognitive-overload>
-A human leader may be cognitively overloaded in daily life. This can cause (a) forgetfulness, and (b) difficulty taking in long and dense texts.
+A human leader may be cognitively overloaded. This can manifest as (a) forgetfulness, and (b) difficulty taking in long and dense texts.
 
 <cognitive-overload.forgetfulness>
 This can increase forgetfulness.
-The difficulty may be retrieving context that was active only once or twice, especially after 1–2 days. Brief reminders can help the leader recall it.
+Forgetfulness need not mean deletion of memory — memory can persist and consolidate well while recent context remains hard to retrieve after 1–2 days (or more). The remedy is to help recall: successful recall of a vague memory makes it easier to retrieve next time.
 
 <cognitive-overload.forgetfulness.mitigation>
-Help the leader recall.
+Help the human 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 help the leader recognize the work and resume it.
 </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 can remain active across multiple days.
-If the leader is vague on recent work, recall this `cognitive-overload` section and apply `cognitive-overload.forgetfulness.mitigation`.
+If the leader is vague on what you have been doing, 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.

package/plugins/soft-skills/skills/handoff/SKILL.md

@@ -38,6 +38,7 @@ Your summary should be structured, concise, actionable, and written along the li
    - Paths of files (any file type) you read or executed, and commands you ran, in the beginning of the session, to absorb the baseline context needed to start work.
    - Details that aren’t obvious.
    - Tacit knowledge you gained through direct experience that lives only in your head. Preserve it so the successor gets an epistemologically holistic picture.
+   - Wilkenfeld's understanding, Allison Hill's cognitive control: The working model you developed.
    - Any promises made to the user.
 
 ### How to approach this handoff task