Merge pull request #732 from alirezarezvani/dev

Author: alirezarezvani

.claude-plugin/marketplace.json

@@ -970,6 +970,26 @@
       ],
       "category": "productivity"
     },
+    {
+      "name": "handoff",
+      "source": "./productivity/handoff",
+      "description": "Compact the current conversation into a handoff document for another agent to pick up. Configurable save location, redaction enforcement, SessionStart auto-load + SessionEnd reminder, self-check fidelity script, --refresh flag, mtime-guarded cleanup. Inspired by Matt Pocock's handoff (MIT).",
+      "version": "2.8.2",
+      "author": {
+        "name": "Alireza Rezvani"
+      },
+      "keywords": [
+        "handoff",
+        "productivity",
+        "session-continuity",
+        "redaction",
+        "session-start-hook",
+        "session-end-hook",
+        "self-check",
+        "matt-pocock"
+      ],
+      "category": "productivity"
+    },
     {
       "name": "landing",
       "source": "./marketing/landing",

.codex/skills-index.json

@@ -3,7 +3,7 @@
   "name": "claude-code-skills",
   "description": "Production-ready skill packages for AI agents - Marketing, Engineering, Product, C-Level, PM, and RA/QM",
   "repository": "https://github.com/alirezarezvani/claude-skills",
-  "total_skills": 320,
+  "total_skills": 322,
   "skills": [
     {
       "name": "business-growth-skills",
@@ -567,7 +567,7 @@
       "name": "code-reviewer",
       "source": "../../engineering-team/skills/code-reviewer",
       "category": "engineering",
-      "description": "Code review automation for TypeScript, JavaScript, Python, Go, Swift, Kotlin. Analyzes PRs for complexity and risk, checks code quality for SOLID violations and code smells, generates review reports. Use when reviewing pull requests, analyzing code quality, identifying issues, generating review checklists."
+      "description": "Code review automation for TypeScript, JavaScript, Python, Go, Swift, Kotlin, C#, and .NET. Analyzes PRs for complexity and risk, checks code quality for SOLID violations and code smells, generates review reports. Use when reviewing pull requests, analyzing code quality, identifying issues, generating review checklists."
     },
     {
       "name": "coverage",
@@ -685,15 +685,15 @@
     },
     {
       "name": "review",
-      "source": "../../engineering-team/self-improving-agent/skills/review",
+      "source": "../../engineering-team/playwright-pro/skills/review",
       "category": "engineering",
-      "description": "Analyze auto-memory for promotion candidates, stale entries, consolidation opportunities, and health metrics."
+      "description": ">-"
     },
     {
       "name": "review",
-      "source": "../../engineering-team/playwright-pro/skills/review",
+      "source": "../../engineering-team/self-improving-agent/skills/review",
       "category": "engineering",
-      "description": ">-"
+      "description": "Analyze auto-memory for promotion candidates, stale entries, consolidation opportunities, and health metrics."
     },
     {
       "name": "security-pen-testing",
@@ -911,6 +911,12 @@
       "category": "engineering-advanced",
       "description": "Generate pragmatic CI/CD pipelines from detected project stack signals \u2014 fast baseline generation, repeatable checks, environment-aware deployment stages. Use when setting up CI for a new project, refactoring existing pipelines, or standardizing deployment workflows across multiple repos."
     },
+    {
+      "name": "claude-coach",
+      "source": "../../engineering/claude-coach/skills/claude-coach",
+      "category": "engineering-advanced",
+      "description": "Personal coach that teaches users to become Claude power users. Use this skill the FIRST time a user asks to \"learn Claude\", \"be a power user\", \"coach me\", \"teach me Claude tricks\", \"what can Claude do\", \"make me better at prompting\", or any variation. After activation, also use it on EVERY subsequent turn to detect missed optimization opportunities (vague prompts, ignored capabilities, manual work Claude could automate) and surface a single power-user tip. Trigger generously \u2014 most users do not know what they do not know, so err on the side of coaching."
+    },
     {
       "name": "code-tour",
       "source": "../../engineering/code-tour/skills/code-tour",
@@ -1153,15 +1159,15 @@
     },
     {
       "name": "run",
-      "source": "../../engineering/autoresearch-agent/skills/run",
+      "source": "../../engineering/agenthub/skills/run",
       "category": "engineering-advanced",
-      "description": "Run a single experiment iteration. Edit the target file, evaluate, keep or discard."
+      "description": "One-shot lifecycle command that chains init \u2192 baseline \u2192 spawn \u2192 eval \u2192 merge in a single invocation."
     },
     {
       "name": "run",
-      "source": "../../engineering/agenthub/skills/run",
+      "source": "../../engineering/autoresearch-agent/skills/run",
       "category": "engineering-advanced",
-      "description": "One-shot lifecycle command that chains init \u2192 baseline \u2192 spawn \u2192 eval \u2192 merge in a single invocation."
+      "description": "Run a single experiment iteration. Edit the target file, evaluate, keep or discard."
     },
     {
       "name": "runbook-generator",
@@ -1249,15 +1255,15 @@
     },
     {
       "name": "status",
-      "source": "../../engineering/autoresearch-agent/skills/status",
+      "source": "../../engineering/agenthub/skills/status",
       "category": "engineering-advanced",
-      "description": "Show experiment dashboard with results, active loops, and progress."
+      "description": "Show DAG state, agent progress, and branch status for an AgentHub session."
     },
     {
       "name": "status",
-      "source": "../../engineering/agenthub/skills/status",
+      "source": "../../engineering/autoresearch-agent/skills/status",
       "category": "engineering-advanced",
-      "description": "Show DAG state, agent progress, and branch status for an AgentHub session."
+      "description": "Show experiment dashboard with results, active loops, and progress."
     },
     {
       "name": "tc-tracker",
@@ -1697,6 +1703,12 @@
       "category": "productivity",
       "description": "Captures and organizes chaotic brain dumps into a structured, actionable system with zero information loss. Use this skill whenever the user says 'capture this', 'brain dump', 'let me dump some ideas', 'I've got a bunch of thoughts', 'here's everything on my mind', 'idea dump', 'let me get this out of my head', 'I need to organize my thoughts', 'here's what I'm thinking', or any variation where someone is unloading a messy stream of ideas, tasks, thoughts, and plans wanting them turned into something coherent. Also trigger when the user pastes or dictates a long, unstructured block of mixed ideas \u2014 even without the exact phrase \u2014 the intent is the same. Fast-to-action by design: no upfront intake. Output is four sections (Projects/Ideas, Tasks, Connections, How I Can Help) ending with a directive question. Asks at most one mid-organization clarifying question when a single item is genuinely ambiguous between task and project."
     },
+    {
+      "name": "handoff",
+      "source": "../../productivity/handoff/skills/handoff",
+      "category": "productivity",
+      "description": "Compact the current conversation into a handoff document for another agent to pick up. Save to a user-configured location (OS temp, home folder, or per-project .handoff/), redact secrets before write, suggest skills for the next session, and auto-load the latest handoff on the next SessionStart. First-run setup asks where to save so the project folder never gets cluttered. Use when the user says 'hand this off', 'handoff doc', 'summarize this for a new session', 'compact this conversation', 'I'm ending this session', 'pick this up later', or any variation signaling intent to pass work to a fresh agent. Also trigger on implicit signals: the user announcing they're switching machines, ending the day mid-task, or context is growing long without a natural stopping point."
+    },
     {
       "name": "inbox-setup",
       "source": "../../productivity/email/skills/inbox-setup",
@@ -1953,7 +1965,7 @@
       "description": "Software engineering and technical skills"
     },
     "engineering-advanced": {
-      "count": 76,
+      "count": 77,
       "source": "../../engineering",
       "description": "Advanced engineering skills - agents, RAG, MCP, CI/CD, databases, observability"
     },
@@ -1973,7 +1985,7 @@
       "description": "Product management and design skills"
     },
     "productivity": {
-      "count": 4,
+      "count": 5,
       "source": "../../productivity",
       "description": "Personal-productivity skills - capture, email, reflect"
     },

.codex/skills/claude-coach

@@ -0,0 +1 @@
+../../engineering/claude-coach/skills/claude-coach

.codex/skills/handoff

@@ -1 +1 @@
-../../engineering/handoff/skills/handoff
+../../productivity/handoff/skills/handoff

.codex/skills/review

@@ -1 +1 @@
-../../engineering-team/playwright-pro/skills/review
+../../engineering-team/self-improving-agent/skills/review

.codex/skills/run

@@ -1 +1 @@
-../../engineering/agenthub/skills/run
+../../engineering/autoresearch-agent/skills/run

.codex/skills/status

@@ -1 +1 @@
-../../engineering/agenthub/skills/status
+../../engineering/autoresearch-agent/skills/status

.gemini/skills-index.json

@@ -1,7 +1,7 @@
 {
   "version": "1.0.0",
   "name": "gemini-cli-skills",
-  "total_skills": 392,
+  "total_skills": 393,
   "skills": [
     {
       "name": "README",
@@ -31,7 +31,7 @@
     {
       "name": "cs-backend-engineer",
       "category": "agent",
-      "description": "Backend-engineering orchestrator. Walks the 7 Matt Pocock forcing questions (read/write ratio + QPS, tenancy, sync vs async, data sensitivity, pattern, RPO/RTO, SLO), picks the language + pattern profile, forks into specialists (api-design-reviewer, database-designer, migration-architect, slo-architect, observability-designer) rather than reimplementing their scope. Forks own context. Invoke via /cs:backend-review or Agent({subagent_type:\"cs-backend-engineer\",...})."
+      "description": "Backend-engineering orchestrator. Walks the 7 Matt Pocock forcing questions (read/write ratio + QPS, tenancy, sync vs async, data sensitivity, pattern, RPO/RTO, SLO), picks the language + pattern profile, forks into specialists (api-design-reviewer, database-designer, migration-architect, observability-designer, slo-architect \u2014 listed alphabetically; workflow order is dependency-driven) rather than reimplementing their scope. Forks own context. Invoke via /cs:backend-review or Agent({subagent_type:\"cs-backend-engineer\",...})."
     },
     {
       "name": "cs-ceo-advisor",
@@ -66,12 +66,12 @@
     {
       "name": "cs-frontend-engineer",
       "category": "agent",
-      "description": "Frontend-engineering orchestrator. Walks the 7 Matt Pocock forcing questions (device, LCP target, rendering, bundle budget, SEO vs auth, design system, WCAG), picks the framework/rendering profile, forks into specialists (a11y-audit, performance-profiler, epic-design, apple-hig-expert, playwright-pro) rather than reimplementing their scope. Forks own context. Invoke via /cs:frontend-review or Agent({subagent_type:\"cs-frontend-engineer\",...})."
+      "description": "Frontend-engineering orchestrator. Walks the 7 Matt Pocock forcing questions (device, LCP target, rendering, bundle budget, SEO vs auth, design system, WCAG), picks the framework/rendering profile, forks into specialists (a11y-audit, apple-hig-expert, epic-design, performance-profiler, playwright-pro \u2014 listed alphabetically; workflow order is dependency-driven) rather than reimplementing their scope. Forks own context. Invoke via /cs:frontend-review or Agent({subagent_type:\"cs-frontend-engineer\",...})."
     },
     {
       "name": "cs-fullstack-engineer",
       "category": "agent",
-      "description": "Fullstack-engineering orchestrator. Walks the Matt Pocock 7-question forcing-question grill, runs the deterministic profile picker, then forks into the POWERFUL-tier specialists (api-design-reviewer, database-designer, slo-architect, ci-cd-pipeline-builder, performance-profiler) rather than reimplementing their scope. Forks own context so heavy ingestion does not pollute parent thread. Invoke via /cs:fullstack-review or Agent({subagent_type:\"cs-fullstack-engineer\",...})."
+      "description": "Fullstack-engineering orchestrator. Walks the Matt Pocock 7-question forcing-question grill, runs the deterministic profile picker, then forks into the POWERFUL-tier specialists (api-design-reviewer, ci-cd-pipeline-builder, database-designer, performance-profiler, slo-architect \u2014 listed alphabetically; workflow order is dependency-driven) rather than reimplementing their scope. Forks own context so heavy ingestion does not pollute parent thread. Invoke via /cs:fullstack-review or Agent({subagent_type:\"cs-fullstack-engineer\",...})."
     },
     {
       "name": "cs-growth-strategist",
@@ -1009,7 +1009,7 @@
       "description": ">-"
     },
     {
-      "name": "skills-status",
+      "name": "skills-status-2",
       "category": "engineering",
       "description": "Memory health dashboard showing line counts, topic files, capacity, stale entries, and recommendations."
     },
@@ -1198,11 +1198,6 @@
       "category": "engineering-advanced",
       "description": "Docs-anchored grilling session \u2014 challenges a plan against the project's existing language (CONTEXT.md) and recorded decisions (docs/adr/), and updates those files inline as terminology and decisions crystallise. Use when user wants to stress-test a plan against documented domain language, or mentions \"grill with docs\"."
     },
-    {
-      "name": "handoff",
-      "category": "engineering-advanced",
-      "description": "Compact the current conversation into a handoff document for another agent to pick up. References existing artifacts (PRDs, plans, ADRs, issues, commits, diffs) by path or URL instead of duplicating them. Use when user wants to hand off the conversation to a fresh agent or starts a new session that picks up prior work."
-    },
     {
       "name": "helm-chart-builder",
       "category": "engineering-advanced",
@@ -1358,6 +1353,11 @@
       "category": "engineering-advanced",
       "description": "Use when adding, retiring, or auditing feature flags. Triggers on \"add a flag\", \"ship behind a flag\", \"rollout plan\", \"kill switch\", \"stale flags\", \"flag debt\", \"LaunchDarkly\", \"GrowthBook\", \"Statsig\", \"Unleash\", \"Flipt\", or any progressive-delivery question. Ships flag debt scanner, rollout planner, and kill-switch auditor (all stdlib Python), 4 references on flag taxonomy + provider trade-offs + rollout strategies + lifecycle, plus a /flag-cleanup slash command."
     },
+    {
+      "name": "skills-handoff",
+      "category": "engineering-advanced",
+      "description": "Compact the current conversation into a handoff document for another agent to pick up. References existing artifacts (PRDs, plans, ADRs, issues, commits, diffs) by path or URL instead of duplicating them. Use when user wants to hand off the conversation to a fresh agent or starts a new session that picks up prior work."
+    },
     {
       "name": "skills-kubernetes-operator",
       "category": "engineering-advanced",
@@ -1773,6 +1773,11 @@
       "category": "productivity",
       "description": "Captures and organizes chaotic brain dumps into a structured, actionable system with zero information loss. Use this skill whenever the user says 'capture this', 'brain dump', 'let me dump some ideas', 'I've got a bunch of thoughts', 'here's everything on my mind', 'idea dump', 'let me get this out of my head', 'I need to organize my thoughts', 'here's what I'm thinking', or any variation where someone is unloading a messy stream of ideas, tasks, thoughts, and plans wanting them turned into something coherent. Also trigger when the user pastes or dictates a long, unstructured block of mixed ideas \u2014 even without the exact phrase \u2014 the intent is the same. Fast-to-action by design: no upfront intake. Output is four sections (Projects/Ideas, Tasks, Connections, How I Can Help) ending with a directive question. Asks at most one mid-organization clarifying question when a single item is genuinely ambiguous between task and project."
     },
+    {
+      "name": "handoff",
+      "category": "productivity",
+      "description": "Compact the current conversation into a handoff document for another agent to pick up. Save to a user-configured location (OS temp, home folder, or per-project .handoff/), redact secrets before write, suggest skills for the next session, and auto-load the latest handoff on the next SessionStart. First-run setup asks where to save so the project folder never gets cluttered. Use when the user says 'hand this off', 'handoff doc', 'summarize this for a new session', 'compact this conversation', 'I'm ending this session', 'pick this up later', or any variation signaling intent to pass work to a fresh agent. Also trigger on implicit signals: the user announcing they're switching machines, ending the day mid-task, or context is growing long without a natural stopping point."
+    },
     {
       "name": "inbox-setup",
       "category": "productivity",
@@ -2014,7 +2019,7 @@
       "description": "Product resources"
     },
     "productivity": {
-      "count": 4,
+      "count": 5,
       "description": "Productivity resources"
     },
     "project-management": {

.gemini/skills/handoff/SKILL.md

@@ -1 +1 @@
-../../../engineering/handoff/skills/handoff/SKILL.md
+../../../productivity/handoff/skills/handoff/SKILL.md

.gemini/skills/skills-handoff/SKILL.md

@@ -0,0 +1 @@
+../../../engineering/handoff/skills/handoff/SKILL.md