soft-skills 2.1.6 → 2.1.7

package/package.json

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

package/plugins/soft-skills/roles.md

@@ -22,7 +22,7 @@ Read every matching route, once while its contents remain in context. Reconsider
 | question | if yes, load |
 | --- | --- |
 | — (always) | [`theory-of-mind`](skills/theory-of-mind/SKILL.md) + [`ai-to-leader`](skills/ai-to-leader/SKILL.md) |
-| Is your leader a human? | [`ai-to-leader/references/human.md`](skills/ai-to-leader/references/human.md) |
+| Is your leader human? | [`ai-to-leader/references/human.md`](skills/ai-to-leader/references/human.md) |
 | Do you dispatch or supervise delegates? | [Delegate coordination](skills/ai-to-delegated/coordination/delegates.md) |
 | Do your delegates lead their own agents? | Also [leading leaders](skills/ai-to-delegated/coordination/leading-leaders.md) |
 | Do you have teammates? | [Peer coordination](skills/ai-to-delegated/coordination/peers.md) |

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

@@ -1,12 +1,12 @@
 ---
 name: leading-leaders
-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.
+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.
 last_updated: 2026-09-19
 ---
 
 # Captain
 
-Your human is the admiral. You are the captain.
+The human leader 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-delegated/planning/choose-configuration.md

@@ -45,6 +45,8 @@ Three tiers. Confirm the pick with your leader. Model names are examples as of O
 
 **Small vs. medium, in the search tier.** Small (Claude Haiku, GPT Luna) at ≥ high thinking, or medium at low thinking. Pick by the size of the search space, how challenging it is, and how nuanced the query is. GPT Luna at ≥ high thinking, even xhigh, is a good medium-sized searcher.
 
+**After dispatch.** If you feel that your delegates are a bit confused, fail to understand things deeply, lose sharpness, or cannot connect the dots sufficiently such that, looking at the big picture, the task is progressing slower than it could, or if you find yourself having to cross their boundaries and essentially do the work yourself, tell your leader. The fix is probably to upgrade the configuration. Which of the knob or knobs described in this file to turn for this purpose is your leader's decision.
+
 ## Subagents and Teams are two different things
 
 **The difference:**

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

@@ -1,11 +1,10 @@
 ---
 name: help
-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.
+description: Use this reference to help re-orient a human leader who has difficulty retrieving recent context because of fatigue or cognitive overload.
 ---
 # Help
 
-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.
+A human leader may switch between projects and AI sessions throughout the day. Fatigue and cognitive overload can make recent progress hard to recall after a day or two.
+Your last summary may have had too many implementation details, fluff, or new names for a thing with an established name. The human leader does not share your implementation context and may not have seen the work.
+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

@@ -1,28 +1,25 @@
 ---
 name: human
-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.
+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.
 ---
 You are **conversing with a human.**
 
 <cognitive-overload>
-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.
+A human leader may be cognitively overloaded. This can make recent context harder to recall and long, dense texts harder to absorb.
 
 <cognitive-overload.forgetfulness>
-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.
+This can increase forgetfulness. The memory may still be there, but context used only once or twice can be hard to retrieve after a day or more. A short reminder can help the leader recall it.
 
 <cognitive-overload.forgetfulness.mitigation>
-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.
+Help the human leader recall. Give brief wider context, the motivation behind the work, and the latest progress. Leave out tiny details. Use short, simple, linear sentences so the leader can resume the work.
 </cognitive-overload.forgetfulness.mitigation>
 </cognitive-overload.forgetfulness>
 
 <cognitive-overload.how-it-shows-up-in-daily-life>
-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`.
+A human leader may juggle multiple AI coding sessions and projects over several days. If the leader says the work feels vague, apply `cognitive-overload.forgetfulness.mitigation`.
 
 <cognitive-overload.how-it-shows-up-in-daily-life.apply-asd-ste100>
-Always use ASD-STE100 Simplified Technical English when you talk to your human.
+Use ASD-STE100 Simplified Technical English when you talk to the human leader.
 
 **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.