@iceinvein/agent-skills 0.1.34 → 0.1.35

package/README.md

@@ -7,9 +7,9 @@
 [![Codex](https://img.shields.io/badge/Codex-supported-green)](https://openai.com/codex)
 [![Gemini CLI](https://img.shields.io/badge/Gemini_CLI-supported-orange)](https://github.com/google-gemini/gemini-cli)
 
-Thinking frameworks from foundational software engineering texts — installed as skills for AI coding agents.
+Thinking frameworks from foundational software engineering texts, installed as skills for AI coding agents.
 
-Each skill encodes a specific design methodology (Brooks, Parnas, Rams, Feathers, etc.) so your agent doesn't just write code — it reasons about structure, coupling, complexity, and perception the way these authors taught us to.
+Each skill encodes a specific design methodology (Brooks, Parnas, Rams, Feathers, etc.) so your agent doesn't just write code; it reasons about structure, coupling, complexity, and perception the way these authors taught us to.
 
 ## Install
 
@@ -26,22 +26,22 @@ Auto-detects Claude Code, Cursor, Codex, or Gemini CLI. Use `--tool claude` to t
 
 ### Code Architecture
 
-Skills that analyze how code is structured — module boundaries, coupling, complexity, contracts, and evolution over time.
+Skills that analyze how code is structured: module boundaries, coupling, complexity, contracts, and evolution over time.
 
 | Skill | Based on | What it does |
 |-------|----------|--------------|
 | **complexity-accountant** | Ousterhout, *A Philosophy of Software Design* | Treats complexity as a finite budget. Every abstraction must justify itself by being deep (simple interface, rich functionality), not shallow. |
-| **contract-enforcer** | Meyer, *Object-Oriented Software Construction* | Before writing non-trivial functions, articulates preconditions, postconditions, invariants, and failure contracts — then verifies the implementation satisfies them. |
+| **contract-enforcer** | Meyer, *Object-Oriented Software Construction* | Before writing non-trivial functions, articulates preconditions, postconditions, invariants, and failure contracts, then verifies the implementation satisfies them. |
 | **module-secret-auditor** | Parnas, *On the Criteria for Decomposing Systems into Modules* | Every module should hide exactly one design decision that's likely to change. Boundaries drawn by change-reason, not by noun or technical layer. |
 | **coupling-auditor** | Constantine & Yourdon, *Structured Design* | Classifies coupling between modules on the spectrum (data > stamp > control > common > content) and recommends one step down. |
 | **simplicity-razor** | Hickey, *Simple Made Easy* | Distinguishes simple (not interleaved) from easy (familiar). Names the strands, detects complecting, and decomplects or justifies. |
 | **error-strategist** | Duffy & Abrahams | Classifies errors (bug/recoverable/fatal), assigns exception safety guarantees (nothrow/strong/basic), and designs recovery boundaries. |
-| **seam-finder** | Feathers, *Working Effectively with Legacy Code* | Before changing existing code, finds seams — places where behavior can be altered without editing the code at that point. Minimal incision, preserve the unknown. |
-| **evolution-analyzer** | Lehman, *Laws of Software Evolution* | Evaluates changes through the Laws of Software Evolution — assessing trajectory, debt impact, and whether the system is adapting or accreting. |
+| **seam-finder** | Feathers, *Working Effectively with Legacy Code* | Before changing existing code, finds seams: places where behavior can be altered without editing the code at that point. Minimal incision, preserve the unknown. |
+| **evolution-analyzer** | Lehman, *Laws of Software Evolution* | Evaluates changes through the Laws of Software Evolution: assessing trajectory, debt impact, and whether the system is adapting or accreting. |
 | **cohesion-analyzer** | Constantine & Yourdon, *Structured Design* | Classifies module focus on the 7-level cohesion spectrum (coincidental → functional), identifies mixed responsibilities, and proposes specific split lines. |
 | **demeter-enforcer** | Lieberherr, *Law of Demeter* | Detects chain violations, parameter drilling, and hidden traversal. Fixes with "tell, don't ask" or parameter narrowing to reduce structural coupling. |
 | **dependency-direction-auditor** | Martin, *Clean Architecture* | Traces imports across architectural layers, classifies direction violations by severity (hard/soft/transitive), and recommends specific inversions. |
-| **type-driven-designer** | Wlaschin, *Domain Modeling Made Functional*; Minsky, "Make Illegal States Unrepresentable" | Uses the type system to encode business rules — branded types for validated values, discriminated unions for state machines, elimination of primitive obsession. |
+| **type-driven-designer** | Wlaschin, *Domain Modeling Made Functional*; Minsky, "Make Illegal States Unrepresentable" | Uses the type system to encode business rules: branded types for validated values, discriminated unions for state machines, elimination of primitive obsession. |
 | **cqs-auditor** | Meyer, *Object-Oriented Software Construction* | Classifies functions as commands (change state) or queries (return data), detects mixed violations, and separates side effects from return values. |
 
 ### UI & Visual Design
@@ -50,7 +50,7 @@ Skills that evaluate interfaces through perception, cognition, and design princi
 
 | Skill | Based on | What it does |
 |-------|----------|--------------|
-| **rams-design-audit** | Dieter Rams, *Ten Principles of Good Design* | Every visual element must earn its presence — if removing it loses nothing, remove it. Less but better. |
+| **rams-design-audit** | Dieter Rams, *Ten Principles of Good Design* | Every visual element must earn its presence. If removing it loses nothing, remove it. Less but better. |
 | **cognitive-load-auditor** | Jeff Johnson, *Designing with the Mind in Mind* | Evaluates UI against Miller's Law (working memory), Hick's Law (decision time), Fitts's Law (target size), and cognitive load theory. |
 | **gestalt-reviewer** | Gestalt psychology | Checks that visual grouping matches logical grouping through proximity, similarity, closure, continuity, and figure-ground analysis. |
 
@@ -61,23 +61,23 @@ Skills for reviewing high-level architecture, messaging patterns, and data flow.
 | Skill | Based on | What it does |
 |-------|----------|--------------|
 | **design-review** | Brooks, *The Design of Design* | Interactive interview that tests conceptual integrity, constraint exploitation, removal discipline, and scope control. |
-| **codebase-architecture** | — | Architecture review for existing codebases or structured design for new projects. Includes a comprehensive patterns reference. |
+| **codebase-architecture** | – | Architecture review for existing codebases or structured design for new projects. Includes a comprehensive patterns reference. |
 | **integration-pattern-auditor** | Hohpe & Woolf, *Enterprise Integration Patterns* | Names the integration pattern (channel, router, transformer, endpoint), verifies delivery guarantees, and identifies missing infrastructure like dead letter queues and idempotency. |
-| **unidirectional-flow-enforcer** | Elm Architecture | Enforces unidirectional state flow in UI applications — events up, state down, mutations in one place. Detects bidirectional mutations and cascading effects. |
+| **unidirectional-flow-enforcer** | Elm Architecture | Enforces unidirectional state flow in UI applications: events up, state down, mutations in one place. Detects bidirectional mutations and cascading effects. |
 | **event-design-reviewer** | Evans, Vernon, Dahan (DDD) | Events should describe what happened in the domain, not what changed in the database. Applies the domain expert test, evaluates payload design, and catches CRUD naming smells. |
 | **bounded-context-auditor** | Evans, *Domain-Driven Design* | Detects linguistic fractures (polysemous terms, contested models), draws context maps with relationship types, and identifies leaking language and shared model pollution. |
 | **port-adapter-auditor** | Cockburn, *Hexagonal Architecture* | Maps driving and driven ports, classifies boundary health (clean/missing/leaking/wrong-language), and ensures core testability and infrastructure swappability. |
-| **idempotency-guardian** | Helland, *Idempotence Is Not a Medical Condition* | Audits mutation endpoints and event handlers for retry safety — classifies natural idempotency, checks protection mechanisms, and evaluates side effect safety. |
-| **composability-auditor** | McIlroy, Pike, Thompson — Unix Philosophy | Identifies reuse blockers (hidden I/O, non-standard interfaces, statefulness) and decomposes self-sufficient units into composable pieces. |
-| **temporal-coupling-detector** | Beck, Fowler — software engineering canon | Detects hidden ordering dependencies (two-phase init, method order, invisible preconditions) and enforces them through types, parameters, and factory patterns. |
+| **idempotency-guardian** | Helland, *Idempotence Is Not a Medical Condition* | Audits mutation endpoints and event handlers for retry safety: classifies natural idempotency, checks protection mechanisms, and evaluates side effect safety. |
+| **composability-auditor** | McIlroy, Pike, Thompson (Unix Philosophy) | Identifies reuse blockers (hidden I/O, non-standard interfaces, statefulness) and decomposes self-sufficient units into composable pieces. |
+| **temporal-coupling-detector** | Beck, Fowler (software engineering canon) | Detects hidden ordering dependencies (two-phase init, method order, invisible preconditions) and enforces them through types, parameters, and factory patterns. |
 
 ### Communication
 
-Skills that control how the agent communicates — output compression, token efficiency, and response style.
+Skills that control how the agent communicates: output compression, token efficiency, and response style.
 
 | Skill | Based on | What it does |
 |-------|----------|--------------|
-| **terse** | Caveman (refined) | Professional output compression — cuts ~50-60% of tokens by eliminating LLM verbosity habits (preambles, hedging, trailing summaries) while keeping proper grammar. Three levels: clean, tight, sharp. |
+| **terse** | Caveman (refined) | Professional output compression: cuts ~20-30% of tokens by eliminating LLM verbosity habits (preambles, hedging, trailing summaries) while keeping proper grammar. Three levels: clean, tight, sharp. |
 
 ### Career & Writing
 
@@ -145,10 +145,10 @@ To pin to the current version, do nothing: skills are not auto-updated. `update`
 
 ## Activation Modes (Claude Code)
 
-Some skills — like `terse` — support activation modes. Pick one at install time:
+Some skills (like `terse`) support activation modes. Pick one at install time:
 
-- **session** (default) — invoke the skill manually with `/<skill>` each session
-- **global** — auto-activate every Claude Code session via a `SessionStart` hook in `.claude/settings.json`
+- **session** (default): invoke the skill manually with `/<skill>` each session
+- **global**: auto-activate every Claude Code session via a `SessionStart` hook in `.claude/settings.json`
 
 If a skill declares activation support and you're installing for Claude Code interactively, the CLI prompts you. Use `--activation session` or `--activation global` for scripted installs. `remove` strips the hook cleanly; `update` preserves your choice across version bumps.
 
@@ -158,7 +158,7 @@ If a skill declares activation support and you're installing for Claude Code int
 |------|:---:|:---:|
 | Claude Code | Yes | Yes |
 | Cursor | Yes | Yes |
-| Codex | Yes | — |
+| Codex | Yes | – |
 | Gemini CLI | Yes | Yes |
 
 ## How It Works

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iceinvein/agent-skills",
-  "version": "0.1.34",
+  "version": "0.1.35",
   "description": "Install agent skills into AI coding tools",
   "author": "iceinvein",
   "license": "MIT",
@@ -20,6 +20,7 @@
     "skill:bump:all": "bun run src/cli/index.ts bump --all",
     "skill:bump:check": "bun run src/cli/index.ts bump --all --dry-run",
     "build:index": "bun run scripts/build-index.ts",
+    "skill:audit": "bun run scripts/audit-skills.ts",
     "release": "bash scripts/release.sh"
   },
   "keywords": [

package/skills/bounded-context-auditor/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "bounded-context-auditor",
-  "version": "1.0.0",
-  "description": "Evans-inspired bounded context analysis — detect linguistic fractures, draw context maps, identify leaking language and shared model pollution",
+  "version": "1.0.1",
+  "description": "Evans-inspired bounded context analysis: detect linguistic fractures, draw context maps, identify leaking language and shared model pollution",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/cognitive-load-auditor/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "cognitive-load-auditor",
-  "version": "1.0.0",
-  "description": "Jeff Johnson-inspired cognitive load analysis — evaluate UI against Miller's Law, Hick's Law, Fitts's Law, and working memory limits",
+  "version": "1.0.1",
+  "description": "Jeff Johnson-inspired cognitive load analysis: evaluate UI against Miller's Law, Hick's Law, Fitts's Law, and working memory limits",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/cohesion-analyzer/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "cohesion-analyzer",
-  "version": "1.0.0",
-  "description": "Constantine & Yourdon-inspired cohesion analysis — classify module focus on the 7-level spectrum, find split lines, reduce mixed responsibilities",
+  "version": "1.0.1",
+  "description": "Constantine & Yourdon-inspired cohesion analysis: classify module focus on the 7-level spectrum, find split lines, reduce mixed responsibilities",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/complexity-accountant/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "complexity-accountant",
-  "version": "1.0.0",
-  "description": "Ousterhout-inspired complexity analysis — deep vs shallow modules, complexity budget, justified abstractions",
+  "version": "1.0.1",
+  "description": "Ousterhout-inspired complexity analysis: deep vs shallow modules, complexity budget, justified abstractions",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/composability-auditor/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "composability-auditor",
-  "version": "1.0.0",
-  "description": "Unix Philosophy-inspired composability analysis — identify reuse blockers, decompose self-sufficient units into composable pieces with standard interfaces",
+  "version": "1.0.1",
+  "description": "Unix Philosophy-inspired composability analysis: identify reuse blockers, decompose self-sufficient units into composable pieces with standard interfaces",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/contract-enforcer/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "contract-enforcer",
-  "version": "1.0.0",
-  "description": "Meyer-inspired Design by Contract — preconditions, postconditions, invariants, and failure contracts for non-trivial functions",
+  "version": "1.0.1",
+  "description": "Meyer-inspired Design by Contract: preconditions, postconditions, invariants, and failure contracts for non-trivial functions",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/coupling-auditor/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "coupling-auditor",
-  "version": "1.0.0",
-  "description": "Constantine & Yourdon-inspired coupling analysis — classify, measure, and reduce interdependence between modules",
+  "version": "1.0.1",
+  "description": "Constantine & Yourdon-inspired coupling analysis: classify, measure, and reduce interdependence between modules",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/cover-letter/skill.json

@@ -0,0 +1,26 @@
+{
+  "name": "cover-letter",
+  "version": "1.0.0",
+  "description": "Cover letter suite router. Dispatches to write, audit, rewrite, or persona subcommands and shares file I/O (PDF, DOCX, MD/MDX, URL), output formats, and writing conventions across the suite",
+  "author": "iceinvein",
+  "type": "prompt",
+  "tools": ["claude", "cursor", "codex", "gemini"],
+  "files": {
+    "prompt": "SKILL.md"
+  },
+  "install": {
+    "claude": {
+      "prompt": ".claude/skills/cover-letter/SKILL.md"
+    },
+    "cursor": {
+      "prompt": ".cursor/rules/cover-letter.mdc"
+    },
+    "codex": {
+      "prompt": "AGENTS.md",
+      "append": true
+    },
+    "gemini": {
+      "prompt": ".gemini/skills/cover-letter.md"
+    }
+  }
+}

package/skills/cover-letter-audit/skill.json

@@ -0,0 +1,26 @@
+{
+  "name": "cover-letter-audit",
+  "version": "1.0.0",
+  "description": "Scores a cover letter on 100 points across content/fit, structure, voice/humanness, and correctness; detects AI-generated-content signals and produces a prioritized fix list",
+  "author": "iceinvein",
+  "type": "prompt",
+  "tools": ["claude", "cursor", "codex", "gemini"],
+  "files": {
+    "prompt": "SKILL.md"
+  },
+  "install": {
+    "claude": {
+      "prompt": ".claude/skills/cover-letter-audit/SKILL.md"
+    },
+    "cursor": {
+      "prompt": ".cursor/rules/cover-letter-audit.mdc"
+    },
+    "codex": {
+      "prompt": "AGENTS.md",
+      "append": true
+    },
+    "gemini": {
+      "prompt": ".gemini/skills/cover-letter-audit.md"
+    }
+  }
+}

package/skills/cover-letter-persona/skill.json

@@ -0,0 +1,26 @@
+{
+  "name": "cover-letter-persona",
+  "version": "1.0.0",
+  "description": "Reusable writing personas built on the NNGroup 4-dimension tone framework, adapted for professional correspondence and used by cover-letter-write and cover-letter-rewrite",
+  "author": "iceinvein",
+  "type": "prompt",
+  "tools": ["claude", "cursor", "codex", "gemini"],
+  "files": {
+    "prompt": "SKILL.md"
+  },
+  "install": {
+    "claude": {
+      "prompt": ".claude/skills/cover-letter-persona/SKILL.md"
+    },
+    "cursor": {
+      "prompt": ".cursor/rules/cover-letter-persona.mdc"
+    },
+    "codex": {
+      "prompt": "AGENTS.md",
+      "append": true
+    },
+    "gemini": {
+      "prompt": ".gemini/skills/cover-letter-persona.md"
+    }
+  }
+}

package/skills/cover-letter-rewrite/skill.json

@@ -0,0 +1,26 @@
+{
+  "name": "cover-letter-rewrite",
+  "version": "1.0.0",
+  "description": "Audit-driven targeted rewrite of an existing cover letter. Focus modes: humanize, align, tighten, structure, tone; preserves voice where it already works",
+  "author": "iceinvein",
+  "type": "prompt",
+  "tools": ["claude", "cursor", "codex", "gemini"],
+  "files": {
+    "prompt": "SKILL.md"
+  },
+  "install": {
+    "claude": {
+      "prompt": ".claude/skills/cover-letter-rewrite/SKILL.md"
+    },
+    "cursor": {
+      "prompt": ".cursor/rules/cover-letter-rewrite.mdc"
+    },
+    "codex": {
+      "prompt": "AGENTS.md",
+      "append": true
+    },
+    "gemini": {
+      "prompt": ".gemini/skills/cover-letter-rewrite.md"
+    }
+  }
+}

package/skills/cover-letter-write/skill.json

@@ -0,0 +1,26 @@
+{
+  "name": "cover-letter-write",
+  "version": "1.0.0",
+  "description": "Generates a cover letter from a resume and job description. Outputs markdown, DOCX, and PDF; enforces human prose, maps every claim to a resume bullet, and covers top JD requirements without keyword stuffing",
+  "author": "iceinvein",
+  "type": "prompt",
+  "tools": ["claude", "cursor", "codex", "gemini"],
+  "files": {
+    "prompt": "SKILL.md"
+  },
+  "install": {
+    "claude": {
+      "prompt": ".claude/skills/cover-letter-write/SKILL.md"
+    },
+    "cursor": {
+      "prompt": ".cursor/rules/cover-letter-write.mdc"
+    },
+    "codex": {
+      "prompt": "AGENTS.md",
+      "append": true
+    },
+    "gemini": {
+      "prompt": ".gemini/skills/cover-letter-write.md"
+    }
+  }
+}

package/skills/cqs-auditor/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "cqs-auditor",
-  "version": "1.0.0",
-  "description": "Meyer-inspired Command-Query Separation — classify functions as commands or queries, detect mixed violations, separate side effects from return values",
+  "version": "1.0.1",
+  "description": "Meyer-inspired Command-Query Separation: classify functions as commands or queries, detect mixed violations, separate side effects from return values",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/demeter-enforcer/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "demeter-enforcer",
-  "version": "1.0.0",
-  "description": "Lieberherr-inspired Law of Demeter analysis — detect chain violations, parameter drilling, and hidden traversal; fix with tell-don't-ask or parameter narrowing",
+  "version": "1.0.1",
+  "description": "Lieberherr-inspired Law of Demeter analysis: detect chain violations, parameter drilling, and hidden traversal; fix with tell-don't-ask or parameter narrowing",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/dependency-direction-auditor/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "dependency-direction-auditor",
-  "version": "1.0.0",
-  "description": "Martin-inspired dependency direction analysis — trace imports across layers, classify violations by severity, recommend inversion",
+  "version": "1.0.1",
+  "description": "Martin-inspired dependency direction analysis: trace imports across layers, classify violations by severity, recommend inversion",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/design-review/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: design-integrity-review
+name: design-review
 description: Use when reviewing, evaluating, or giving feedback on a design document, technical spec, architecture doc, system design, product spec, API design, or database schema — especially after AI helped write or brainstorm it. Always use this skill when the user shares a design and asks you to review it, check if it holds together, or help scope it down. Trigger on phrases like "review my design", "does this design make sense", "can you look at this spec", "not sure what to cut", "scope this down", "feels like too much", "check if this holds together", "design review", or any request to evaluate a design document. Also trigger when the user describes a design that sounds like a feature list without a unifying idea, mentions AI helped create it, or expresses uncertainty about whether the design is coherent.
 ---
 

package/skills/design-review/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "design-review",
-  "version": "1.0.0",
-  "description": "Brooks-inspired design integrity review — tests conceptual integrity, constraint exploitation, removal discipline, and scope control",
+  "version": "1.0.1",
+  "description": "Brooks-inspired design integrity review: tests conceptual integrity, constraint exploitation, removal discipline, and scope control",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/error-strategist/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "error-strategist",
-  "version": "1.0.0",
-  "description": "Duffy & Abrahams-inspired error handling — classify errors (bug/recoverable/fatal), assign safety guarantees, design recovery boundaries",
+  "version": "1.0.1",
+  "description": "Duffy & Abrahams-inspired error handling: classify errors (bug/recoverable/fatal), assign safety guarantees, design recovery boundaries",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/event-design-reviewer/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "event-design-reviewer",
-  "version": "1.0.0",
-  "description": "Evans/Vernon/Dahan-inspired event design — domain-meaningful naming, fat payloads, schema evolution, and the domain expert test",
+  "version": "1.0.1",
+  "description": "Evans/Vernon/Dahan-inspired event design: domain-meaningful naming, fat payloads, schema evolution, and the domain expert test",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/evolution-analyzer/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "evolution-analyzer",
-  "version": "1.0.0",
-  "description": "Lehman-inspired software evolution analysis — trajectory assessment, debt visibility, and change impact on system health",
+  "version": "1.0.1",
+  "description": "Lehman-inspired software evolution analysis: trajectory assessment, debt visibility, and change impact on system health",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/gestalt-reviewer/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "gestalt-reviewer",
-  "version": "1.0.0",
-  "description": "Gestalt-inspired visual perception audit — proximity, similarity, closure, continuity, and figure-ground analysis for UI layouts",
+  "version": "1.0.1",
+  "description": "Gestalt-inspired visual perception audit: proximity, similarity, closure, continuity, and figure-ground analysis for UI layouts",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/idempotency-guardian/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "idempotency-guardian",
-  "version": "1.0.0",
-  "description": "Helland-inspired idempotency analysis — classify mutation points, check protection mechanisms, evaluate side effect safety for retry-safe systems",
+  "version": "1.0.1",
+  "description": "Helland-inspired idempotency analysis: classify mutation points, check protection mechanisms, evaluate side effect safety for retry-safe systems",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/index.json

@@ -1,9 +1,9 @@
 [
   {
     "name": "bounded-context-auditor",
-    "description": "Evans-inspired bounded context analysis — detect linguistic fractures, draw context maps, identify leaking language and shared model pollution",
+    "description": "Evans-inspired bounded context analysis: detect linguistic fractures, draw context maps, identify leaking language and shared model pollution",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "domain"
     ],
@@ -22,9 +22,9 @@
   },
   {
     "name": "cognitive-load-auditor",
-    "description": "Jeff Johnson-inspired cognitive load analysis — evaluate UI against Miller's Law, Hick's Law, Fitts's Law, and working memory limits",
+    "description": "Jeff Johnson-inspired cognitive load analysis: evaluate UI against Miller's Law, Hick's Law, Fitts's Law, and working memory limits",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "ui"
     ],
@@ -32,9 +32,9 @@
   },
   {
     "name": "cohesion-analyzer",
-    "description": "Constantine & Yourdon-inspired cohesion analysis — classify module focus on the 7-level spectrum, find split lines, reduce mixed responsibilities",
+    "description": "Constantine & Yourdon-inspired cohesion analysis: classify module focus on the 7-level spectrum, find split lines, reduce mixed responsibilities",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "architecture"
     ],
@@ -42,9 +42,9 @@
   },
   {
     "name": "complexity-accountant",
-    "description": "Ousterhout-inspired complexity analysis — deep vs shallow modules, complexity budget, justified abstractions",
+    "description": "Ousterhout-inspired complexity analysis: deep vs shallow modules, complexity budget, justified abstractions",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "any"
     ],
@@ -52,9 +52,9 @@
   },
   {
     "name": "composability-auditor",
-    "description": "Unix Philosophy-inspired composability analysis — identify reuse blockers, decompose self-sufficient units into composable pieces with standard interfaces",
+    "description": "Unix Philosophy-inspired composability analysis: identify reuse blockers, decompose self-sufficient units into composable pieces with standard interfaces",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "any"
     ],
@@ -62,9 +62,9 @@
   },
   {
     "name": "contract-enforcer",
-    "description": "Meyer-inspired Design by Contract — preconditions, postconditions, invariants, and failure contracts for non-trivial functions",
+    "description": "Meyer-inspired Design by Contract: preconditions, postconditions, invariants, and failure contracts for non-trivial functions",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "any"
     ],
@@ -72,19 +72,49 @@
   },
   {
     "name": "coupling-auditor",
-    "description": "Constantine & Yourdon-inspired coupling analysis — classify, measure, and reduce interdependence between modules",
+    "description": "Constantine & Yourdon-inspired coupling analysis: classify, measure, and reduce interdependence between modules",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "architecture"
     ],
     "quick": true
   },
+  {
+    "name": "cover-letter",
+    "description": "Cover letter suite router. Dispatches to write, audit, rewrite, or persona subcommands and shares file I/O (PDF, DOCX, MD/MDX, URL), output formats, and writing conventions across the suite",
+    "type": "prompt",
+    "version": "1.0.0"
+  },
+  {
+    "name": "cover-letter-audit",
+    "description": "Scores a cover letter on 100 points across content/fit, structure, voice/humanness, and correctness; detects AI-generated-content signals and produces a prioritized fix list",
+    "type": "prompt",
+    "version": "1.0.0"
+  },
+  {
+    "name": "cover-letter-persona",
+    "description": "Reusable writing personas built on the NNGroup 4-dimension tone framework, adapted for professional correspondence and used by cover-letter-write and cover-letter-rewrite",
+    "type": "prompt",
+    "version": "1.0.0"
+  },
+  {
+    "name": "cover-letter-rewrite",
+    "description": "Audit-driven targeted rewrite of an existing cover letter. Focus modes: humanize, align, tighten, structure, tone; preserves voice where it already works",
+    "type": "prompt",
+    "version": "1.0.0"
+  },
+  {
+    "name": "cover-letter-write",
+    "description": "Generates a cover letter from a resume and job description. Outputs markdown, DOCX, and PDF; enforces human prose, maps every claim to a resume bullet, and covers top JD requirements without keyword stuffing",
+    "type": "prompt",
+    "version": "1.0.0"
+  },
   {
     "name": "cqs-auditor",
-    "description": "Meyer-inspired Command-Query Separation — classify functions as commands or queries, detect mixed violations, separate side effects from return values",
+    "description": "Meyer-inspired Command-Query Separation: classify functions as commands or queries, detect mixed violations, separate side effects from return values",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "architecture"
     ],
@@ -92,9 +122,9 @@
   },
   {
     "name": "demeter-enforcer",
-    "description": "Lieberherr-inspired Law of Demeter analysis — detect chain violations, parameter drilling, and hidden traversal; fix with tell-don't-ask or parameter narrowing",
+    "description": "Lieberherr-inspired Law of Demeter analysis: detect chain violations, parameter drilling, and hidden traversal; fix with tell-don't-ask or parameter narrowing",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "architecture"
     ],
@@ -102,9 +132,9 @@
   },
   {
     "name": "dependency-direction-auditor",
-    "description": "Martin-inspired dependency direction analysis — trace imports across layers, classify violations by severity, recommend inversion",
+    "description": "Martin-inspired dependency direction analysis: trace imports across layers, classify violations by severity, recommend inversion",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "architecture"
     ],
@@ -112,9 +142,9 @@
   },
   {
     "name": "design-review",
-    "description": "Brooks-inspired design integrity review — tests conceptual integrity, constraint exploitation, removal discipline, and scope control",
+    "description": "Brooks-inspired design integrity review: tests conceptual integrity, constraint exploitation, removal discipline, and scope control",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "any"
     ],
@@ -122,9 +152,9 @@
   },
   {
     "name": "error-strategist",
-    "description": "Duffy & Abrahams-inspired error handling — classify errors (bug/recoverable/fatal), assign safety guarantees, design recovery boundaries",
+    "description": "Duffy & Abrahams-inspired error handling: classify errors (bug/recoverable/fatal), assign safety guarantees, design recovery boundaries",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "errors"
     ],
@@ -132,9 +162,9 @@
   },
   {
     "name": "event-design-reviewer",
-    "description": "Evans/Vernon/Dahan-inspired event design — domain-meaningful naming, fat payloads, schema evolution, and the domain expert test",
+    "description": "Evans/Vernon/Dahan-inspired event design: domain-meaningful naming, fat payloads, schema evolution, and the domain expert test",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "integration",
       "domain"
@@ -143,9 +173,9 @@
   },
   {
     "name": "evolution-analyzer",
-    "description": "Lehman-inspired software evolution analysis — trajectory assessment, debt visibility, and change impact on system health",
+    "description": "Lehman-inspired software evolution analysis: trajectory assessment, debt visibility, and change impact on system health",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "any"
     ],
@@ -153,9 +183,9 @@
   },
   {
     "name": "gestalt-reviewer",
-    "description": "Gestalt-inspired visual perception audit — proximity, similarity, closure, continuity, and figure-ground analysis for UI layouts",
+    "description": "Gestalt-inspired visual perception audit: proximity, similarity, closure, continuity, and figure-ground analysis for UI layouts",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "ui"
     ],
@@ -163,9 +193,9 @@
   },
   {
     "name": "idempotency-guardian",
-    "description": "Helland-inspired idempotency analysis — classify mutation points, check protection mechanisms, evaluate side effect safety for retry-safe systems",
+    "description": "Helland-inspired idempotency analysis: classify mutation points, check protection mechanisms, evaluate side effect safety for retry-safe systems",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "integration"
     ],
@@ -179,9 +209,9 @@
   },
   {
     "name": "integration-pattern-auditor",
-    "description": "Hohpe & Woolf-inspired messaging analysis — name the integration pattern, verify delivery guarantees, identify missing infrastructure",
+    "description": "Hohpe & Woolf-inspired messaging analysis: name the integration pattern, verify delivery guarantees, identify missing infrastructure",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "integration"
     ],
@@ -195,9 +225,9 @@
   },
   {
     "name": "module-secret-auditor",
-    "description": "Parnas-inspired information hiding analysis — module boundaries drawn by change-reason, not by noun or technical layer",
+    "description": "Parnas-inspired information hiding analysis: module boundaries drawn by change-reason, not by noun or technical layer",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "architecture"
     ],
@@ -205,9 +235,9 @@
   },
   {
     "name": "port-adapter-auditor",
-    "description": "Cockburn-inspired hexagonal architecture analysis — identify ports and adapters, classify boundary health, ensure core testability and swappability",
+    "description": "Cockburn-inspired hexagonal architecture analysis: identify ports and adapters, classify boundary health, ensure core testability and swappability",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "architecture"
     ],
@@ -215,9 +245,9 @@
   },
   {
     "name": "rams-design-audit",
-    "description": "Dieter Rams-inspired design audit — every visual element must earn its presence, less but better, clarity through restraint",
+    "description": "Dieter Rams-inspired design audit: every visual element must earn its presence, less but better, clarity through restraint",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "ui"
     ],
@@ -225,9 +255,9 @@
   },
   {
     "name": "seam-finder",
-    "description": "Feathers-inspired legacy code modification — find seams, make minimal incisions, preserve existing behavior",
+    "description": "Feathers-inspired legacy code modification: find seams, make minimal incisions, preserve existing behavior",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "legacy"
     ],
@@ -235,9 +265,9 @@
   },
   {
     "name": "simplicity-razor",
-    "description": "Hickey-inspired simplicity analysis — simple vs easy, complecting detection, strand decomposition",
+    "description": "Hickey-inspired simplicity analysis: simple vs easy, complecting detection, strand decomposition",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "any"
     ],
@@ -245,9 +275,9 @@
   },
   {
     "name": "temporal-coupling-detector",
-    "description": "Hidden ordering dependency analysis — detect two-phase init, method order dependencies, invisible preconditions, and resource lifecycle violations; fix with types, parameters, and factory patterns",
+    "description": "Hidden ordering dependency analysis: detect two-phase init, method order dependencies, invisible preconditions, and resource lifecycle violations; fix with types, parameters, and factory patterns",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "any"
     ],
@@ -261,9 +291,9 @@
   },
   {
     "name": "type-driven-designer",
-    "description": "Wlaschin & Minsky-inspired type design — make illegal states unrepresentable through branded types, discriminated unions, and domain-encoded constraints",
+    "description": "Wlaschin & Minsky-inspired type design: make illegal states unrepresentable through branded types, discriminated unions, and domain-encoded constraints",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "any"
     ],
@@ -271,9 +301,9 @@
   },
   {
     "name": "unidirectional-flow-enforcer",
-    "description": "Elm Architecture-inspired data flow analysis — enforce unidirectional state flow, detect bidirectional mutations, trace state lifecycle in UI applications",
+    "description": "Elm Architecture-inspired data flow analysis: enforce unidirectional state flow, detect bidirectional mutations, trace state lifecycle in UI applications",
     "type": "prompt",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "applies": [
       "ui"
     ],

package/skills/integration-pattern-auditor/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "integration-pattern-auditor",
-  "version": "1.0.0",
-  "description": "Hohpe & Woolf-inspired messaging analysis — name the integration pattern, verify delivery guarantees, identify missing infrastructure",
+  "version": "1.0.1",
+  "description": "Hohpe & Woolf-inspired messaging analysis: name the integration pattern, verify delivery guarantees, identify missing infrastructure",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/module-secret-auditor/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "module-secret-auditor",
-  "version": "1.0.0",
-  "description": "Parnas-inspired information hiding analysis — module boundaries drawn by change-reason, not by noun or technical layer",
+  "version": "1.0.1",
+  "description": "Parnas-inspired information hiding analysis: module boundaries drawn by change-reason, not by noun or technical layer",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/port-adapter-auditor/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "port-adapter-auditor",
-  "version": "1.0.0",
-  "description": "Cockburn-inspired hexagonal architecture analysis — identify ports and adapters, classify boundary health, ensure core testability and swappability",
+  "version": "1.0.1",
+  "description": "Cockburn-inspired hexagonal architecture analysis: identify ports and adapters, classify boundary health, ensure core testability and swappability",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/rams-design-audit/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "rams-design-audit",
-  "version": "1.0.0",
-  "description": "Dieter Rams-inspired design audit — every visual element must earn its presence, less but better, clarity through restraint",
+  "version": "1.0.1",
+  "description": "Dieter Rams-inspired design audit: every visual element must earn its presence, less but better, clarity through restraint",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/seam-finder/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "seam-finder",
-  "version": "1.0.0",
-  "description": "Feathers-inspired legacy code modification — find seams, make minimal incisions, preserve existing behavior",
+  "version": "1.0.1",
+  "description": "Feathers-inspired legacy code modification: find seams, make minimal incisions, preserve existing behavior",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/simplicity-razor/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "simplicity-razor",
-  "version": "1.0.0",
-  "description": "Hickey-inspired simplicity analysis — simple vs easy, complecting detection, strand decomposition",
+  "version": "1.0.1",
+  "description": "Hickey-inspired simplicity analysis: simple vs easy, complecting detection, strand decomposition",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/temporal-coupling-detector/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "temporal-coupling-detector",
-  "version": "1.0.0",
-  "description": "Hidden ordering dependency analysis — detect two-phase init, method order dependencies, invisible preconditions, and resource lifecycle violations; fix with types, parameters, and factory patterns",
+  "version": "1.0.1",
+  "description": "Hidden ordering dependency analysis: detect two-phase init, method order dependencies, invisible preconditions, and resource lifecycle violations; fix with types, parameters, and factory patterns",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/type-driven-designer/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "type-driven-designer",
-  "version": "1.0.0",
-  "description": "Wlaschin & Minsky-inspired type design — make illegal states unrepresentable through branded types, discriminated unions, and domain-encoded constraints",
+  "version": "1.0.1",
+  "description": "Wlaschin & Minsky-inspired type design: make illegal states unrepresentable through branded types, discriminated unions, and domain-encoded constraints",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },

package/skills/unidirectional-flow-enforcer/skill.json

@@ -1,10 +1,15 @@
 {
   "name": "unidirectional-flow-enforcer",
-  "version": "1.0.0",
-  "description": "Elm Architecture-inspired data flow analysis — enforce unidirectional state flow, detect bidirectional mutations, trace state lifecycle in UI applications",
+  "version": "1.0.1",
+  "description": "Elm Architecture-inspired data flow analysis: enforce unidirectional state flow, detect bidirectional mutations, trace state lifecycle in UI applications",
   "author": "iceinvein",
   "type": "prompt",
-  "tools": ["claude", "cursor", "codex", "gemini"],
+  "tools": [
+    "claude",
+    "cursor",
+    "codex",
+    "gemini"
+  ],
   "files": {
     "prompt": "SKILL.md"
   },