diff --git a/skills/elixir-phoenix-assigns-audit/SKILL.md b/skills/elixir-phoenix-assigns-audit/SKILL.md
index 87d1aea..07fc047 100644
--- a/skills/elixir-phoenix-assigns-audit/SKILL.md
+++ b/skills/elixir-phoenix-assigns-audit/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-assigns-audit
-description: 'Elixir/Phoenix: Audit LiveView socket assigns — memory estimates, missing
-  temporary_assigns, unused assigns, unbounded lists needing streams. Use when investigating
-  LiveView memory bloat.'
+description: 'Audit LiveView assigns for memory bloat, dead assigns, and stream candidates.'
 metadata:
-  short-description: 'Elixir/Phoenix: Audit LiveView socket assigns — memory estimates,
-    missing temporary_assigns, unused assigns, unbounded lists needing streams. Use
-    when investigating LiveView memory bloat.'
+  short-description: 'Audit LiveView assigns for memory bloat'
 ---
 
 # LiveView Assigns Audit
diff --git a/skills/elixir-phoenix-assigns-audit/agents/openai.yaml b/skills/elixir-phoenix-assigns-audit/agents/openai.yaml
index 0813db6..657abbf 100644
--- a/skills/elixir-phoenix-assigns-audit/agents/openai.yaml
+++ b/skills/elixir-phoenix-assigns-audit/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Assigns Audit"
-  short_description: "Elixir/Phoenix: Audit LiveView socket assigns — memory estimates, missing temporary_assigns, unused assigns, unbounded lists needing streams. Use when investigating LiveView memory bloat."
+  short_description: "Audit LiveView assigns for memory bloat"
   default_prompt: "Use $elixir-phoenix-assigns-audit for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-audit/SKILL.md b/skills/elixir-phoenix-audit/SKILL.md
index d9edd4e..be5d274 100644
--- a/skills/elixir-phoenix-audit/SKILL.md
+++ b/skills/elixir-phoenix-audit/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-audit
-description: 'Elixir/Phoenix: Project health audit and health check — architecture,
-  performance, security, tests, dependencies. Use quarterly, before releases, after
-  refactors, or when asked about project health.'
+description: 'Audit project health across architecture, security, performance, tests, and deps.'
 metadata:
-  short-description: 'Elixir/Phoenix: Project health audit and health check — architecture,
-    performance, security, tests, dependencies. Use quarterly, before releases, after
-    refactors, or when asked about project health.'
+  short-description: 'Audit Phoenix project health'
 ---
 
 # Project Health Audit
diff --git a/skills/elixir-phoenix-audit/agents/openai.yaml b/skills/elixir-phoenix-audit/agents/openai.yaml
index d384748..7e03a69 100644
--- a/skills/elixir-phoenix-audit/agents/openai.yaml
+++ b/skills/elixir-phoenix-audit/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Audit"
-  short_description: "Elixir/Phoenix: Project health audit and health check — architecture, performance, security, tests, dependencies. Use quarterly, before releases, after refactors, or when asked about project health."
+  short_description: "Audit Phoenix project health"
   default_prompt: "Use $elixir-phoenix-audit for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-boundaries/SKILL.md b/skills/elixir-phoenix-boundaries/SKILL.md
index 48d27ce..0ebe335 100644
--- a/skills/elixir-phoenix-boundaries/SKILL.md
+++ b/skills/elixir-phoenix-boundaries/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-boundaries
-description: Analyze Phoenix context boundaries and module coupling via mix xref.
-  Use when checking cross-context calls, validating dependencies, before splitting
-  modules, or reviewing architecture.
+description: 'Analyze Phoenix context boundaries and coupling with `mix xref`.'
 metadata:
-  short-description: Analyze Phoenix context boundaries and module coupling via mix
-    xref. Use when checking cross-context calls, validating dependencies, before splitting
-    modules, or reviewing architecture.
+  short-description: 'Audit Phoenix context boundaries'
 ---
 
 # Phoenix Context Boundary Validation
diff --git a/skills/elixir-phoenix-boundaries/agents/openai.yaml b/skills/elixir-phoenix-boundaries/agents/openai.yaml
index 857a296..588d718 100644
--- a/skills/elixir-phoenix-boundaries/agents/openai.yaml
+++ b/skills/elixir-phoenix-boundaries/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Boundaries"
-  short_description: "Analyze Phoenix context boundaries and module coupling via mix xref. Use when checking cross-context calls, validating dependencies, before splitting modules, or reviewing architecture."
+  short_description: "Audit Phoenix context boundaries"
   default_prompt: "Use $elixir-phoenix-boundaries for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-brainstorm/SKILL.md b/skills/elixir-phoenix-brainstorm/SKILL.md
index 15fe359..b998840 100644
--- a/skills/elixir-phoenix-brainstorm/SKILL.md
+++ b/skills/elixir-phoenix-brainstorm/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-brainstorm
-description: Brainstorm Elixir/Phoenix features — explore ideas, compare approaches,
-  gather requirements. Use when vague idea, not sure how to approach, or want to discuss
-  before plan.
+description: 'Brainstorm Phoenix features, tradeoffs, and requirements before planning.'
 metadata:
-  short-description: Brainstorm Elixir/Phoenix features — explore ideas, compare approaches,
-    gather requirements. Use when vague idea, not sure how to approach, or want to
-    discuss before plan.
+  short-description: 'Brainstorm Phoenix features'
 ---
 
 # Brainstorm — Adaptive Requirements Gathering
diff --git a/skills/elixir-phoenix-brainstorm/agents/openai.yaml b/skills/elixir-phoenix-brainstorm/agents/openai.yaml
index 9405501..256dcd2 100644
--- a/skills/elixir-phoenix-brainstorm/agents/openai.yaml
+++ b/skills/elixir-phoenix-brainstorm/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Brainstorm"
-  short_description: "Brainstorm Elixir/Phoenix features — explore ideas, compare approaches, gather requirements. Use when vague idea, not sure how to approach, or want to discuss before plan."
+  short_description: "Brainstorm Phoenix features"
   default_prompt: "Use $elixir-phoenix-brainstorm for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-brief/SKILL.md b/skills/elixir-phoenix-brief/SKILL.md
index 212f730..bbd361f 100644
--- a/skills/elixir-phoenix-brief/SKILL.md
+++ b/skills/elixir-phoenix-brief/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-brief
-description: 'Elixir/Phoenix: Interactive briefing of a plan file — explains reasoning,
-  schema decisions, component choices. Use when developers need to understand a plan
-  before approving.'
+description: 'Brief a Phoenix plan so reviewers understand design, schema, and component choices.'
 metadata:
-  short-description: 'Elixir/Phoenix: Interactive briefing of a plan file — explains
-    reasoning, schema decisions, component choices. Use when developers need to understand
-    a plan before approving.'
+  short-description: 'Brief Phoenix implementation plans'
 ---
 
 # Plan Briefing
diff --git a/skills/elixir-phoenix-brief/agents/openai.yaml b/skills/elixir-phoenix-brief/agents/openai.yaml
index b22ad21..a24e418 100644
--- a/skills/elixir-phoenix-brief/agents/openai.yaml
+++ b/skills/elixir-phoenix-brief/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Brief"
-  short_description: "Elixir/Phoenix: Interactive briefing of a plan file — explains reasoning, schema decisions, component choices. Use when developers need to understand a plan before approving."
+  short_description: "Brief Phoenix implementation plans"
   default_prompt: "Use $elixir-phoenix-brief for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-call-tracing/SKILL.md b/skills/elixir-phoenix-call-tracing/SKILL.md
index d5d81e2..1b5012d 100644
--- a/skills/elixir-phoenix-call-tracing/SKILL.md
+++ b/skills/elixir-phoenix-call-tracing/SKILL.md
@@ -1,11 +1,8 @@
 ---
 name: elixir-phoenix-call-tracing
-description: Trace Elixir call trees from entry points via mix xref. Use when debugging
-  data flow, planning signature changes, or understanding how a bug reaches code.
+description: 'Trace Elixir call paths from entry points with `mix xref`.'
 metadata:
-  short-description: Trace Elixir call trees from entry points via mix xref. Use when
-    debugging data flow, planning signature changes, or understanding how a bug reaches
-    code.
+  short-description: 'Trace Elixir call paths with xref'
 ---
 
 # Call Tracing
diff --git a/skills/elixir-phoenix-call-tracing/agents/openai.yaml b/skills/elixir-phoenix-call-tracing/agents/openai.yaml
index 63d179a..d4ae4be 100644
--- a/skills/elixir-phoenix-call-tracing/agents/openai.yaml
+++ b/skills/elixir-phoenix-call-tracing/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Call Tracing"
-  short_description: "Trace Elixir call trees from entry points via mix xref. Use when debugging data flow, planning signature changes, or understanding how a bug reaches code."
+  short_description: "Trace Elixir call paths with xref"
   default_prompt: "Use $elixir-phoenix-call-tracing for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-challenge/SKILL.md b/skills/elixir-phoenix-challenge/SKILL.md
index 2d166c2..966b354 100644
--- a/skills/elixir-phoenix-challenge/SKILL.md
+++ b/skills/elixir-phoenix-challenge/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-challenge
-description: 'Elixir/Phoenix: Challenge mode reviews - rigorous questioning before
-  approving changes. Use when you want thorough scrutiny of Ecto changes, LiveView
-  events, or PR readiness.'
+description: 'Stress-test Phoenix changes with rigorous review questions before approval.'
 metadata:
-  short-description: 'Elixir/Phoenix: Challenge mode reviews - rigorous questioning
-    before approving changes. Use when you want thorough scrutiny of Ecto changes,
-    LiveView events, or PR readiness.'
+  short-description: 'Challenge Phoenix changes before merge'
 ---
 
 # Challenge Mode Reviews
diff --git a/skills/elixir-phoenix-challenge/agents/openai.yaml b/skills/elixir-phoenix-challenge/agents/openai.yaml
index 88719c5..65d6b07 100644
--- a/skills/elixir-phoenix-challenge/agents/openai.yaml
+++ b/skills/elixir-phoenix-challenge/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Challenge"
-  short_description: "Elixir/Phoenix: Challenge mode reviews - rigorous questioning before approving changes. Use when you want thorough scrutiny of Ecto changes, LiveView events, or PR readiness."
+  short_description: "Challenge Phoenix changes before merge"
   default_prompt: "Use $elixir-phoenix-challenge for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-compound-docs/SKILL.md b/skills/elixir-phoenix-compound-docs/SKILL.md
index cbf9fd8..583a41f 100644
--- a/skills/elixir-phoenix-compound-docs/SKILL.md
+++ b/skills/elixir-phoenix-compound-docs/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-compound-docs
-description: Searchable Elixir/Phoenix/Ecto solution documentation system with YAML
-  frontmatter. Builds institutional knowledge from solved problems. Use when consulting
-  past solutions before investigating new issues.
+description: 'Search past Phoenix solution docs before starting a new investigation.'
 metadata:
-  short-description: Searchable Elixir/Phoenix/Ecto solution documentation system
-    with YAML frontmatter. Builds institutional knowledge from solved problems. Use
-    when consulting past solutions before investigating new issues.
+  short-description: 'Search Phoenix solution docs'
 ---
 
 # Compound Docs — Institutional Knowledge Base
diff --git a/skills/elixir-phoenix-compound-docs/agents/openai.yaml b/skills/elixir-phoenix-compound-docs/agents/openai.yaml
index 30641da..f714d1c 100644
--- a/skills/elixir-phoenix-compound-docs/agents/openai.yaml
+++ b/skills/elixir-phoenix-compound-docs/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Compound Docs"
-  short_description: "Searchable Elixir/Phoenix/Ecto solution documentation system with YAML frontmatter. Builds institutional knowledge from solved problems. Use when consulting past solutions before investigating new issues."
+  short_description: "Search Phoenix solution docs"
   default_prompt: "Use $elixir-phoenix-compound-docs for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-compound/SKILL.md b/skills/elixir-phoenix-compound/SKILL.md
index bc1d459..4791104 100644
--- a/skills/elixir-phoenix-compound/SKILL.md
+++ b/skills/elixir-phoenix-compound/SKILL.md
@@ -1,11 +1,8 @@
 ---
 name: elixir-phoenix-compound
-description: 'Elixir/Phoenix: Capture solved problems as searchable solution docs.
-  Use after fixing bugs, when "that worked", or after successful $elixir-phoenix-review or $elixir-phoenix-investigate.'
+description: 'Capture a solved Phoenix problem as a reusable solution doc.'
 metadata:
-  short-description: 'Elixir/Phoenix: Capture solved problems as searchable solution
-    docs. Use after fixing bugs, when "that worked", or after successful $elixir-phoenix-review
-    or $elixir-phoenix-investigate.'
+  short-description: 'Capture reusable Phoenix fix docs'
 ---
 
 # Compound — Capture Solutions as Knowledge
diff --git a/skills/elixir-phoenix-compound/agents/openai.yaml b/skills/elixir-phoenix-compound/agents/openai.yaml
index c4d9488..a36052c 100644
--- a/skills/elixir-phoenix-compound/agents/openai.yaml
+++ b/skills/elixir-phoenix-compound/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Compound"
-  short_description: "Elixir/Phoenix: Capture solved problems as searchable solution docs. Use after fixing bugs, when \"that worked\", or after successful $elixir-phoenix-review or $elixir-phoenix-investigate."
+  short_description: "Capture reusable Phoenix fix docs"that worked\", or after successful $elixir-phoenix-review or $elixir-phoenix-investigate."
   default_prompt: "Use $elixir-phoenix-compound for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-deploy/SKILL.md b/skills/elixir-phoenix-deploy/SKILL.md
index b195653..f87f9ef 100644
--- a/skills/elixir-phoenix-deploy/SKILL.md
+++ b/skills/elixir-phoenix-deploy/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-deploy
-description: Elixir/Phoenix deployment patterns — Dockerfile, fly.toml, runtime.exs,
-  mix release, rel/ overlays. Use when configuring Fly.io, Docker, CI/CD, health checks,
-  or production migrations.
+description: 'Apply Phoenix deployment patterns for Docker, Fly.io, releases, and migrations.'
 metadata:
-  short-description: Elixir/Phoenix deployment patterns — Dockerfile, fly.toml, runtime.exs,
-    mix release, rel/ overlays. Use when configuring Fly.io, Docker, CI/CD, health
-    checks, or production migrations.
+  short-description: 'Phoenix deployment patterns'
 ---
 
 # Elixir/Phoenix Deployment Reference
diff --git a/skills/elixir-phoenix-deploy/agents/openai.yaml b/skills/elixir-phoenix-deploy/agents/openai.yaml
index 41b160f..8831565 100644
--- a/skills/elixir-phoenix-deploy/agents/openai.yaml
+++ b/skills/elixir-phoenix-deploy/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Deploy"
-  short_description: "Elixir/Phoenix deployment patterns — Dockerfile, fly.toml, runtime.exs, mix release, rel/ overlays. Use when configuring Fly.io, Docker, CI/CD, health checks, or production migrations."
+  short_description: "Phoenix deployment patterns"
   default_prompt: "Use $elixir-phoenix-deploy for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-document/SKILL.md b/skills/elixir-phoenix-document/SKILL.md
index 8812f85..75eac12 100644
--- a/skills/elixir-phoenix-document/SKILL.md
+++ b/skills/elixir-phoenix-document/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-document
-description: Write @moduledoc and @doc annotations into Elixir source files. Use ONLY
-  when the user explicitly asks to generate documentation for modules, contexts, or
-  schemas.
+description: 'Write `@moduledoc` and `@doc` only when the user explicitly asks.'
 metadata:
-  short-description: Write @moduledoc and @doc annotations into Elixir source files.
-    Use ONLY when the user explicitly asks to generate documentation for modules,
-    contexts, or schemas.
+  short-description: 'Generate Elixir docs on request'
 ---
 
 # Document
diff --git a/skills/elixir-phoenix-document/agents/openai.yaml b/skills/elixir-phoenix-document/agents/openai.yaml
index b038988..53d4fff 100644
--- a/skills/elixir-phoenix-document/agents/openai.yaml
+++ b/skills/elixir-phoenix-document/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Document"
-  short_description: "Write @moduledoc and @doc annotations into Elixir source files. Use ONLY when the user explicitly asks to generate documentation for modules, contexts, or schemas."
+  short_description: "Generate Elixir docs on request"
   default_prompt: "Use $elixir-phoenix-document for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-ecto-constraint-debug/SKILL.md b/skills/elixir-phoenix-ecto-constraint-debug/SKILL.md
index fdd7486..7666901 100644
--- a/skills/elixir-phoenix-ecto-constraint-debug/SKILL.md
+++ b/skills/elixir-phoenix-ecto-constraint-debug/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-ecto-constraint-debug
-description: 'Elixir/Phoenix: Debug Ecto constraint violations - trace triggers, check
-  migrations, find duplicate data. Use when seeing unique_constraint, foreign_key_constraint,
-  or check_constraint errors.'
+description: 'Debug Ecto constraint errors by tracing data, migrations, and triggers.'
 metadata:
-  short-description: 'Elixir/Phoenix: Debug Ecto constraint violations - trace triggers,
-    check migrations, find duplicate data. Use when seeing unique_constraint, foreign_key_constraint,
-    or check_constraint errors.'
+  short-description: 'Debug Ecto constraint failures'
 ---
 
 # Ecto Constraint Debugging
diff --git a/skills/elixir-phoenix-ecto-constraint-debug/agents/openai.yaml b/skills/elixir-phoenix-ecto-constraint-debug/agents/openai.yaml
index 24b3417..e8df6db 100644
--- a/skills/elixir-phoenix-ecto-constraint-debug/agents/openai.yaml
+++ b/skills/elixir-phoenix-ecto-constraint-debug/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Ecto Constraint Debug"
-  short_description: "Elixir/Phoenix: Debug Ecto constraint violations - trace triggers, check migrations, find duplicate data. Use when seeing unique_constraint, foreign_key_constraint, or check_constraint errors."
+  short_description: "Debug Ecto constraint failures"
   default_prompt: "Use $elixir-phoenix-ecto-constraint-debug for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-ecto-patterns/SKILL.md b/skills/elixir-phoenix-ecto-patterns/SKILL.md
index 205b98c..e7dbef5 100644
--- a/skills/elixir-phoenix-ecto-patterns/SKILL.md
+++ b/skills/elixir-phoenix-ecto-patterns/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-ecto-patterns
-description: 'Elixir/Phoenix: Ecto patterns — schemas, changesets, queries, migrations,
-  Multi, associations, preloads, upserts. Use when editing Repo calls, Ecto.Query,
-  or schema fields. Skip for Ash.'
+description: 'Apply Ecto patterns for schemas, changesets, queries, migrations, and preloads.'
 metadata:
-  short-description: 'Elixir/Phoenix: Ecto patterns — schemas, changesets, queries,
-    migrations, Multi, associations, preloads, upserts. Use when editing Repo calls,
-    Ecto.Query, or schema fields. Skip for Ash.'
+  short-description: 'Apply Ecto schema and query patterns'
 ---
 
 # Ecto Patterns Reference
diff --git a/skills/elixir-phoenix-ecto-patterns/agents/openai.yaml b/skills/elixir-phoenix-ecto-patterns/agents/openai.yaml
index 6bfe423..7e5ae46 100644
--- a/skills/elixir-phoenix-ecto-patterns/agents/openai.yaml
+++ b/skills/elixir-phoenix-ecto-patterns/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Ecto Patterns"
-  short_description: "Elixir/Phoenix: Ecto patterns — schemas, changesets, queries, migrations, Multi, associations, preloads, upserts. Use when editing Repo calls, Ecto.Query, or schema fields. Skip for Ash."
+  short_description: "Apply Ecto schema and query patterns"
   default_prompt: "Use $elixir-phoenix-ecto-patterns for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-elixir-idioms/SKILL.md b/skills/elixir-phoenix-elixir-idioms/SKILL.md
index f25c11a..d6b02f3 100644
--- a/skills/elixir-phoenix-elixir-idioms/SKILL.md
+++ b/skills/elixir-phoenix-elixir-idioms/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-elixir-idioms
-description: OTP/BEAM patterns and Elixir idioms — GenServer, Supervisor, Task, Registry,
-  pattern matching, with chains, pipes. Use when designing processes or debugging
-  BEAM issues.
+description: 'Apply Elixir and OTP idioms for processes, tasks, registries, and control flow.'
 metadata:
-  short-description: OTP/BEAM patterns and Elixir idioms — GenServer, Supervisor,
-    Task, Registry, pattern matching, with chains, pipes. Use when designing processes
-    or debugging BEAM issues.
+  short-description: 'Apply Elixir and OTP idioms'
 ---
 
 # Elixir Idioms
diff --git a/skills/elixir-phoenix-elixir-idioms/agents/openai.yaml b/skills/elixir-phoenix-elixir-idioms/agents/openai.yaml
index a0b6856..620be34 100644
--- a/skills/elixir-phoenix-elixir-idioms/agents/openai.yaml
+++ b/skills/elixir-phoenix-elixir-idioms/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Elixir Idioms"
-  short_description: "OTP/BEAM patterns and Elixir idioms — GenServer, Supervisor, Task, Registry, pattern matching, with chains, pipes. Use when designing processes or debugging BEAM issues."
+  short_description: "Apply Elixir and OTP idioms"
   default_prompt: "Use $elixir-phoenix-elixir-idioms for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-examples/SKILL.md b/skills/elixir-phoenix-examples/SKILL.md
index 390a376..8ba349a 100644
--- a/skills/elixir-phoenix-examples/SKILL.md
+++ b/skills/elixir-phoenix-examples/SKILL.md
@@ -1,11 +1,8 @@
 ---
 name: elixir-phoenix-examples
-description: Provide examples and walkthroughs for Phoenix, LiveView, Ecto, OTP patterns.
-  Use when "how do I...", "show me an example", or "what does X look like".
+description: 'Give Phoenix, LiveView, Ecto, or OTP examples and walkthroughs.'
 metadata:
-  short-description: Provide examples and walkthroughs for Phoenix, LiveView, Ecto,
-    OTP patterns. Use when "how do I...", "show me an example", or "what does X look
-    like".
+  short-description: 'Phoenix and Elixir examples'
 ---
 
 # Examples & Walkthroughs
diff --git a/skills/elixir-phoenix-examples/agents/openai.yaml b/skills/elixir-phoenix-examples/agents/openai.yaml
index f840551..8287ee4 100644
--- a/skills/elixir-phoenix-examples/agents/openai.yaml
+++ b/skills/elixir-phoenix-examples/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Examples"
-  short_description: "Provide examples and walkthroughs for Phoenix, LiveView, Ecto, OTP patterns. Use when \"how do I...\", \"show me an example\", or \"what does X look like\"."
+  short_description: "Phoenix and Elixir examples"how do I...\", \"show me an example\", or \"what does X look like\"."
   default_prompt: "Use $elixir-phoenix-examples for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-full/SKILL.md b/skills/elixir-phoenix-full/SKILL.md
index 436ec2f..662141e 100644
--- a/skills/elixir-phoenix-full/SKILL.md
+++ b/skills/elixir-phoenix-full/SKILL.md
@@ -1,14 +1,8 @@
 ---
 name: elixir-phoenix-full
-description: 'Elixir/Phoenix: Use for large features spanning multiple contexts, new
-  domain modules, or when the user wants autonomous end-to-end implementation. Runs
-  the full plan-implement-review-compound cycle with specialist agents and Iron Laws
-  enforcement.'
+description: 'Run the full plan-build-review-compound workflow for large Phoenix work.'
 metadata:
-  short-description: 'Elixir/Phoenix: Use for large features spanning multiple contexts,
-    new domain modules, or when the user wants autonomous end-to-end implementation.
-    Runs the full plan-implement-review-compound cycle with specialist agents and
-    Iron Laws enforcement.'
+  short-description: 'Run the full Phoenix work loop'
 ---
 
 # Full Phoenix Feature Development
diff --git a/skills/elixir-phoenix-full/agents/openai.yaml b/skills/elixir-phoenix-full/agents/openai.yaml
index c089602..9aa8910 100644
--- a/skills/elixir-phoenix-full/agents/openai.yaml
+++ b/skills/elixir-phoenix-full/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Full"
-  short_description: "Elixir/Phoenix: Use for large features spanning multiple contexts, new domain modules, or when the user wants autonomous end-to-end implementation. Runs the full plan-implement-review-compound cycle with specialist agents and Iron Laws enforcement."
+  short_description: "Run the full Phoenix work loop"
   default_prompt: "Use $elixir-phoenix-full for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-help/SKILL.md b/skills/elixir-phoenix-help/SKILL.md
index 89fe812..1d4cf95 100644
--- a/skills/elixir-phoenix-help/SKILL.md
+++ b/skills/elixir-phoenix-help/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-help
-description: 'Elixir/Phoenix: Recommend the right `$elixir-phoenix-*` skill for planning,
-  review, debug, deploy, or test tasks. Use when "which skill", "what should I use", or
-  "how do I". NOT for /help.'
+description: 'Recommend the right `$elixir-phoenix-*` skill for the current task.'
 metadata:
-  short-description: 'Elixir/Phoenix: Recommend the right `$elixir-phoenix-*` skill
-    for planning, review, debug, deploy, or test tasks. Use when "which skill", "what
-    should I use", or "how do I". NOT for /help.'
+  short-description: 'Route to the right Phoenix skill'
 ---
 
 # Plugin Help — Interactive Command Advisor
diff --git a/skills/elixir-phoenix-help/agents/openai.yaml b/skills/elixir-phoenix-help/agents/openai.yaml
index f1e1a51..84347ec 100644
--- a/skills/elixir-phoenix-help/agents/openai.yaml
+++ b/skills/elixir-phoenix-help/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Help"
-  short_description: "Elixir/Phoenix: Recommend the right $elixir-phoenix-* skill for planning, review, debug, deploy, or test tasks. Use when \"which skill\", \"what should I use\", or \"how do I\". NOT for /help."
+  short_description: "Route to the right Phoenix skill"which skill\", \"what should I use\", or \"how do I\". NOT for /help."
   default_prompt: "Use $elixir-phoenix-help for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-hex-publish/SKILL.md b/skills/elixir-phoenix-hex-publish/SKILL.md
index 7a1baa6..dfcfab5 100644
--- a/skills/elixir-phoenix-hex-publish/SKILL.md
+++ b/skills/elixir-phoenix-hex-publish/SKILL.md
@@ -1,9 +1,8 @@
 ---
 name: elixir-phoenix-hex-publish
-description: Use when preparing or publishing a new Hex.pm release for an Elixir package. Handles release review, README and wiki impact checks, CHANGELOG.md updates, mix.exs version bumps, validation, git tag creation, GitHub release creation, and Hex publish steps.
+description: 'Prepare and publish Hex releases, including versioning, changelog, tags, and release steps.'
 metadata:
-  short-description: Use when preparing or publishing a new Hex.pm release for an
-    Elixir package.
+  short-description: 'Publish a Hex package release'
 ---
 
 # Hex Publish
diff --git a/skills/elixir-phoenix-hex-publish/agents/openai.yaml b/skills/elixir-phoenix-hex-publish/agents/openai.yaml
index 3c2ff58..353d20f 100644
--- a/skills/elixir-phoenix-hex-publish/agents/openai.yaml
+++ b/skills/elixir-phoenix-hex-publish/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Hex Publish"
-  short_description: "Prepare and publish Hex releases"
+  short_description: "Publish a Hex package release"
   default_prompt: "Use $elixir-phoenix-hex-publish to prepare and publish a new Hex.pm release for this project."
diff --git a/skills/elixir-phoenix-hexdocs-fetcher/SKILL.md b/skills/elixir-phoenix-hexdocs-fetcher/SKILL.md
index f14e476..8015cc8 100644
--- a/skills/elixir-phoenix-hexdocs-fetcher/SKILL.md
+++ b/skills/elixir-phoenix-hexdocs-fetcher/SKILL.md
@@ -1,10 +1,8 @@
 ---
 name: elixir-phoenix-hexdocs-fetcher
-description: Fetch HexDocs for Elixir libraries with HTML-to-markdown conversion.
-  Use when looking up docs on hexdocs.pm — modules, functions, guides, changelogs.
+description: 'Fetch and convert HexDocs pages for focused library lookups.'
 metadata:
-  short-description: Fetch HexDocs for Elixir libraries with HTML-to-markdown conversion.
-    Use when looking up docs on hexdocs.pm — modules, functions, guides, changelogs.
+  short-description: 'Fetch focused HexDocs content'
 ---
 
 # HexDocs Fetcher
diff --git a/skills/elixir-phoenix-hexdocs-fetcher/agents/openai.yaml b/skills/elixir-phoenix-hexdocs-fetcher/agents/openai.yaml
index 5afb682..a95a94d 100644
--- a/skills/elixir-phoenix-hexdocs-fetcher/agents/openai.yaml
+++ b/skills/elixir-phoenix-hexdocs-fetcher/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Hexdocs Fetcher"
-  short_description: "Fetch HexDocs for Elixir libraries with HTML-to-markdown conversion. Use when looking up docs on hexdocs.pm — modules, functions, guides, changelogs."
+  short_description: "Fetch focused HexDocs content"
   default_prompt: "Use $elixir-phoenix-hexdocs-fetcher for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-incident-response/SKILL.md b/skills/elixir-phoenix-incident-response/SKILL.md
index 06a01ee..4bf4ce8 100644
--- a/skills/elixir-phoenix-incident-response/SKILL.md
+++ b/skills/elixir-phoenix-incident-response/SKILL.md
@@ -1,10 +1,8 @@
 ---
 name: elixir-phoenix-incident-response
-description: Elixir/Phoenix production incident response — triage, stabilization, root-cause
-  narrowing, and safe hotfix execution.
+description: 'Handle Phoenix production incidents: triage, stabilize, narrow root cause, hotfix safely.'
 metadata:
-  short-description: Elixir/Phoenix production incident response — triage, stabilization,
-    root-cause narrowing, and safe hotfix execution.
+  short-description: 'Handle Phoenix production incidents'
 ---
 
 # Incident Response
diff --git a/skills/elixir-phoenix-init/SKILL.md b/skills/elixir-phoenix-init/SKILL.md
index 9219e10..eacab44 100644
--- a/skills/elixir-phoenix-init/SKILL.md
+++ b/skills/elixir-phoenix-init/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-init
-description: 'Elixir/Phoenix: Initialize plugin in a project — install Iron Laws,
-  auto-activation rules, and reference auto-loading into AGENTS.md. Use when setting
-  up or updating the plugin.'
+description: 'Install or update the plugin rules and AGENTS.md wiring in a Phoenix project.'
 metadata:
-  short-description: 'Elixir/Phoenix: Initialize plugin in a project — install Iron
-    Laws, auto-activation rules, and reference auto-loading into AGENTS.md. Use when
-    setting up or updating the plugin.'
+  short-description: 'Set up Phoenix plugin rules'
 ---
 
 # Plugin Initialization
diff --git a/skills/elixir-phoenix-init/agents/openai.yaml b/skills/elixir-phoenix-init/agents/openai.yaml
index f30a9dc..60d8f2e 100644
--- a/skills/elixir-phoenix-init/agents/openai.yaml
+++ b/skills/elixir-phoenix-init/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Init"
-  short_description: "Elixir/Phoenix: Initialize plugin in a project — install Iron Laws, auto-activation rules, and reference auto-loading into AGENTS.md. Use when setting up or updating the plugin."
+  short_description: "Set up Phoenix plugin rules"
   default_prompt: "Use $elixir-phoenix-init for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-intent-detection/SKILL.md b/skills/elixir-phoenix-intent-detection/SKILL.md
index 58271ee..d709298 100644
--- a/skills/elixir-phoenix-intent-detection/SKILL.md
+++ b/skills/elixir-phoenix-intent-detection/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-intent-detection
-description: 'Elixir/Phoenix: Route ambiguous work requests to the correct `$elixir-phoenix-*`
-  workflow. Use when intent is unclear, mixed (bug + refactor), or user asks "how
-  to approach this".'
+description: 'Route ambiguous Phoenix requests to the right workflow.'
 metadata:
-  short-description: 'Elixir/Phoenix: Route ambiguous work requests to the correct
-    `$elixir-phoenix-*` workflow. Use when intent is unclear, mixed (bug + refactor),
-    or user asks "how to approach this".'
+  short-description: 'Route ambiguous Phoenix requests'
 ---
 
 # Intent Detection — Workflow Routing
diff --git a/skills/elixir-phoenix-intent-detection/agents/openai.yaml b/skills/elixir-phoenix-intent-detection/agents/openai.yaml
index 7cdad6f..194a52a 100644
--- a/skills/elixir-phoenix-intent-detection/agents/openai.yaml
+++ b/skills/elixir-phoenix-intent-detection/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Intent Detection"
-  short_description: "Elixir/Phoenix: Route ambiguous work requests to the correct $elixir-phoenix-* workflow. Use when intent is unclear, mixed (bug + refactor), or user asks \"how to approach this\"."
+  short_description: "Route ambiguous Phoenix requests"how to approach this\"."
   default_prompt: "Use $elixir-phoenix-intent-detection for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-intro/SKILL.md b/skills/elixir-phoenix-intro/SKILL.md
index fb9089c..639bc80 100644
--- a/skills/elixir-phoenix-intro/SKILL.md
+++ b/skills/elixir-phoenix-intro/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-intro
-description: Walk through the Elixir/Phoenix plugin commands, workflow, and features
-  in 6 interactive sections. Use when a new user wants to learn what the plugin offers
-  or needs a refresher on available commands.
+description: 'Walk a new user through the plugin commands and Phoenix workflow.'
 metadata:
-  short-description: Walk through the Elixir/Phoenix plugin commands, workflow, and
-    features in 6 interactive sections. Use when a new user wants to learn what the
-    plugin offers or needs a refresher on available commands.
+  short-description: 'Guided intro to Phoenix plugin workflow'
 ---
 
 # Plugin Introduction Tutorial
diff --git a/skills/elixir-phoenix-intro/agents/openai.yaml b/skills/elixir-phoenix-intro/agents/openai.yaml
index 860ab48..bae59a4 100644
--- a/skills/elixir-phoenix-intro/agents/openai.yaml
+++ b/skills/elixir-phoenix-intro/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Intro"
-  short_description: "Walk through the Elixir/Phoenix plugin commands, workflow, and features in 6 interactive sections. Use when a new user wants to learn what the plugin offers or needs a refresher on available commands."
+  short_description: "Guided intro to Phoenix plugin workflow"
   default_prompt: "Use $elixir-phoenix-intro for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-investigate/SKILL.md b/skills/elixir-phoenix-investigate/SKILL.md
index 0995b90..a64f954 100644
--- a/skills/elixir-phoenix-investigate/SKILL.md
+++ b/skills/elixir-phoenix-investigate/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-investigate
-description: Investigate bugs and errors in Elixir/Phoenix — root-cause analysis for
-  crashes, exceptions, stack traces, test failures. Use --parallel for deep 4-track
-  investigation.
+description: 'Investigate Phoenix bugs, crashes, and test failures to find root cause.'
 metadata:
-  short-description: Investigate bugs and errors in Elixir/Phoenix — root-cause analysis
-    for crashes, exceptions, stack traces, test failures. Use --parallel for deep
-    4-track investigation.
+  short-description: 'Investigate Phoenix bugs and failures'
 ---
 
 # Investigate Bug
diff --git a/skills/elixir-phoenix-investigate/agents/openai.yaml b/skills/elixir-phoenix-investigate/agents/openai.yaml
index edab7e1..6e65883 100644
--- a/skills/elixir-phoenix-investigate/agents/openai.yaml
+++ b/skills/elixir-phoenix-investigate/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Investigate"
-  short_description: "Investigate bugs and errors in Elixir/Phoenix — root-cause analysis for crashes, exceptions, stack traces, test failures. Use --parallel for deep 4-track investigation."
+  short_description: "Investigate Phoenix bugs and failures"
   default_prompt: "Use $elixir-phoenix-investigate for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-learn-from-fix/SKILL.md b/skills/elixir-phoenix-learn-from-fix/SKILL.md
index 6891f99..a9a257f 100644
--- a/skills/elixir-phoenix-learn-from-fix/SKILL.md
+++ b/skills/elixir-phoenix-learn-from-fix/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-learn-from-fix
-description: 'Elixir/Phoenix: Capture lessons after fixing a bug or receiving a correction
-  — ecto, liveview, oban, iron law mistakes. Use when the user corrects your approach
-  or teaches a pattern.'
+description: 'Capture durable lessons after a Phoenix bug fix or correction.'
 metadata:
-  short-description: 'Elixir/Phoenix: Capture lessons after fixing a bug or receiving
-    a correction — ecto, liveview, oban, iron law mistakes. Use when the user corrects
-    your approach or teaches a pattern.'
+  short-description: 'Capture lessons from Phoenix fixes'
 ---
 
 # Learn From Fix
diff --git a/skills/elixir-phoenix-learn-from-fix/agents/openai.yaml b/skills/elixir-phoenix-learn-from-fix/agents/openai.yaml
index 2eac172..369b19d 100644
--- a/skills/elixir-phoenix-learn-from-fix/agents/openai.yaml
+++ b/skills/elixir-phoenix-learn-from-fix/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Learn From Fix"
-  short_description: "Elixir/Phoenix: Capture lessons after fixing a bug or receiving a correction — ecto, liveview, oban, iron law mistakes. Use when the user corrects your approach or teaches a pattern."
+  short_description: "Capture lessons from Phoenix fixes"
   default_prompt: "Use $elixir-phoenix-learn-from-fix for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-liveview-debug/SKILL.md b/skills/elixir-phoenix-liveview-debug/SKILL.md
index 6474267..3d52fa6 100644
--- a/skills/elixir-phoenix-liveview-debug/SKILL.md
+++ b/skills/elixir-phoenix-liveview-debug/SKILL.md
@@ -1,10 +1,8 @@
 ---
 name: elixir-phoenix-liveview-debug
-description: Elixir/Phoenix LiveView debugging workflow — event handling, socket assign
-  lifecycle, stream behavior, reconnect state, and render performance.
+description: 'Debug LiveView events, assigns, reconnects, and render behavior.'
 metadata:
-  short-description: Elixir/Phoenix LiveView debugging workflow — event handling,
-    socket assign lifecycle, stream behavior, reconnect state, and render performance.
+  short-description: 'Debug LiveView lifecycle issues'
 ---
 
 # LiveView Debugging
diff --git a/skills/elixir-phoenix-liveview-patterns/SKILL.md b/skills/elixir-phoenix-liveview-patterns/SKILL.md
index 5186096..91ef641 100644
--- a/skills/elixir-phoenix-liveview-patterns/SKILL.md
+++ b/skills/elixir-phoenix-liveview-patterns/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-liveview-patterns
-description: 'Elixir/Phoenix: LiveView patterns — PubSub, uploads, components, forms,
-  assign_async, streams. Use when building LiveView features or debugging handle_event
-  lifecycle.'
+description: 'Apply LiveView patterns for forms, components, uploads, async, and streams.'
 metadata:
-  short-description: 'Elixir/Phoenix: LiveView patterns — PubSub, uploads, components,
-    forms, assign_async, streams. Use when building LiveView features or debugging
-    handle_event lifecycle.'
+  short-description: 'Apply LiveView feature patterns'
 ---
 
 # LiveView Patterns Reference
diff --git a/skills/elixir-phoenix-liveview-patterns/agents/openai.yaml b/skills/elixir-phoenix-liveview-patterns/agents/openai.yaml
index 6f81ab4..0065b93 100644
--- a/skills/elixir-phoenix-liveview-patterns/agents/openai.yaml
+++ b/skills/elixir-phoenix-liveview-patterns/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Liveview Patterns"
-  short_description: "Elixir/Phoenix: LiveView patterns — PubSub, uploads, components, forms, assign_async, streams. Use when building LiveView features or debugging handle_event lifecycle."
+  short_description: "Apply LiveView feature patterns"
   default_prompt: "Use $elixir-phoenix-liveview-patterns for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-migrations/SKILL.md b/skills/elixir-phoenix-migrations/SKILL.md
index 71843ed..27c9920 100644
--- a/skills/elixir-phoenix-migrations/SKILL.md
+++ b/skills/elixir-phoenix-migrations/SKILL.md
@@ -1,10 +1,8 @@
 ---
 name: elixir-phoenix-migrations
-description: Elixir/Phoenix database migration workflow — additive changes, backfills,
-  and zero-downtime rollout planning for Ecto/Postgres.
+description: 'Plan Ecto and Postgres migrations with additive, backfill-safe rollouts.'
 metadata:
-  short-description: Elixir/Phoenix database migration workflow — additive changes,
-    backfills, and zero-downtime rollout planning for Ecto/Postgres.
+  short-description: 'Plan safe Ecto/Postgres migrations'
 ---
 
 # Ecto Migration Safety Workflow
diff --git a/skills/elixir-phoenix-n1-check/SKILL.md b/skills/elixir-phoenix-n1-check/SKILL.md
index 8a3fa03..1042701 100644
--- a/skills/elixir-phoenix-n1-check/SKILL.md
+++ b/skills/elixir-phoenix-n1-check/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-n1-check
-description: 'Elixir/Phoenix: Scan Ecto code for N+1 anti-patterns — Repo calls in
-  loops, missing preloads, unpreloaded associations. Use when excessive queries reported
-  or wanting an N+1 audit.'
+description: 'Scan Ecto code for N+1 queries and missing preloads.'
 metadata:
-  short-description: 'Elixir/Phoenix: Scan Ecto code for N+1 anti-patterns — Repo
-    calls in loops, missing preloads, unpreloaded associations. Use when excessive
-    queries reported or wanting an N+1 audit.'
+  short-description: 'Audit Ecto queries for N+1s'
 ---
 
 # N+1 Query Detection
diff --git a/skills/elixir-phoenix-n1-check/agents/openai.yaml b/skills/elixir-phoenix-n1-check/agents/openai.yaml
index 3dcd2d1..1b6ac42 100644
--- a/skills/elixir-phoenix-n1-check/agents/openai.yaml
+++ b/skills/elixir-phoenix-n1-check/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "N1 Check"
-  short_description: "Elixir/Phoenix: Scan Ecto code for N+1 anti-patterns — Repo calls in loops, missing preloads, unpreloaded associations. Use when excessive queries reported or wanting an N+1 audit."
+  short_description: "Audit Ecto queries for N+1s"
   default_prompt: "Use $elixir-phoenix-n1-check for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-oban/SKILL.md b/skills/elixir-phoenix-oban/SKILL.md
index 8cddd1c..7ec31d0 100644
--- a/skills/elixir-phoenix-oban/SKILL.md
+++ b/skills/elixir-phoenix-oban/SKILL.md
@@ -1,14 +1,8 @@
 ---
 name: elixir-phoenix-oban
-description: 'Elixir/Phoenix: Oban job processing — workers, perform/1 (OSS) and process/1
-  (Pro), queues, cron, retries, unique jobs, idempotency, Oban Pro (Workflow, Batch,
-  Chunk, Smart Engine), Testing. Use when writing Oban workers, queue config, or debugging
-  jobs.'
+description: 'Apply Oban patterns for workers, queues, retries, uniqueness, and testing.'
 metadata:
-  short-description: 'Elixir/Phoenix: Oban job processing — workers, perform/1 (OSS)
-    and process/1 (Pro), queues, cron, retries, unique jobs, idempotency, Oban Pro
-    (Workflow, Batch, Chunk, Smart Engine), Testing. Use when writing Oban workers,
-    queue config, or debugging jobs.'
+  short-description: 'Apply Oban job and queue patterns'
 ---
 
 # Oban Background Jobs Reference
diff --git a/skills/elixir-phoenix-oban/agents/openai.yaml b/skills/elixir-phoenix-oban/agents/openai.yaml
index 3c12c1c..aee58c3 100644
--- a/skills/elixir-phoenix-oban/agents/openai.yaml
+++ b/skills/elixir-phoenix-oban/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Oban"
-  short_description: "Elixir/Phoenix: Oban job processing — workers, perform/1 (OSS) and process/1 (Pro), queues, cron, retries, unique jobs, idempotency, Oban Pro (Workflow, Batch, Chunk, Smart Engine), Testing. Use when writing Oban workers, queue config, or debugging jobs."
+  short_description: "Apply Oban job and queue patterns"
   default_prompt: "Use $elixir-phoenix-oban for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-observability/SKILL.md b/skills/elixir-phoenix-observability/SKILL.md
index 36abc87..20e87d1 100644
--- a/skills/elixir-phoenix-observability/SKILL.md
+++ b/skills/elixir-phoenix-observability/SKILL.md
@@ -1,10 +1,8 @@
 ---
 name: elixir-phoenix-observability
-description: Elixir/Phoenix observability setup and review — telemetry events, metrics,
-  traces, structured logs, and alertable service indicators.
+description: 'Set up or review Phoenix telemetry, metrics, traces, logs, and alerts.'
 metadata:
-  short-description: Elixir/Phoenix observability setup and review — telemetry events,
-    metrics, traces, structured logs, and alertable service indicators.
+  short-description: 'Review Phoenix telemetry and alerts'
 ---
 
 # Observability
diff --git a/skills/elixir-phoenix-perf/SKILL.md b/skills/elixir-phoenix-perf/SKILL.md
index 6f9c4de..b794e93 100644
--- a/skills/elixir-phoenix-perf/SKILL.md
+++ b/skills/elixir-phoenix-perf/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-perf
-description: Analyze Elixir/Phoenix performance — N+1 queries, assign bloat, ecto
-  optimization, genserver bottlenecks. Use when slowness, timeouts, or high memory
-  reported.
+description: 'Analyze Phoenix slowness, memory, N+1s, and bottlenecks.'
 metadata:
-  short-description: Analyze Elixir/Phoenix performance — N+1 queries, assign bloat,
-    ecto optimization, genserver bottlenecks. Use when slowness, timeouts, or high
-    memory reported.
+  short-description: 'Investigate Phoenix performance issues'
 ---
 
 # Performance Analysis
diff --git a/skills/elixir-phoenix-perf/agents/openai.yaml b/skills/elixir-phoenix-perf/agents/openai.yaml
index 13706e9..3ca2588 100644
--- a/skills/elixir-phoenix-perf/agents/openai.yaml
+++ b/skills/elixir-phoenix-perf/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Perf"
-  short_description: "Analyze Elixir/Phoenix performance — N+1 queries, assign bloat, ecto optimization, genserver bottlenecks. Use when slowness, timeouts, or high memory reported."
+  short_description: "Investigate Phoenix performance issues"
   default_prompt: "Use $elixir-phoenix-perf for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-permissions/SKILL.md b/skills/elixir-phoenix-permissions/SKILL.md
index 54c9808..9bf6263 100644
--- a/skills/elixir-phoenix-permissions/SKILL.md
+++ b/skills/elixir-phoenix-permissions/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-permissions
-description: Recommend safe Bash permissions for Elixir mix commands in settings.json.
-  Use when permission prompts slow workflow, "fix permissions", "reduce prompts",
-  "auto-allow mix".
+description: 'Recommend safe `settings.json` command permissions for Elixir workflows.'
 metadata:
-  short-description: Recommend safe Bash permissions for Elixir mix commands in settings.json.
-    Use when permission prompts slow workflow, "fix permissions", "reduce prompts",
-    "auto-allow mix".
+  short-description: 'Recommend Codex command permissions'
 ---
 
 # Permission Analyzer
diff --git a/skills/elixir-phoenix-permissions/agents/openai.yaml b/skills/elixir-phoenix-permissions/agents/openai.yaml
index 848cd1f..077bc08 100644
--- a/skills/elixir-phoenix-permissions/agents/openai.yaml
+++ b/skills/elixir-phoenix-permissions/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Permissions"
-  short_description: "Recommend safe Bash permissions for Elixir mix commands in settings.json. Use when permission prompts slow workflow, \"fix permissions\", \"reduce prompts\", \"auto-allow mix\"."
+  short_description: "Recommend Codex command permissions"fix permissions\", \"reduce prompts\", \"auto-allow mix\"."
   default_prompt: "Use $elixir-phoenix-permissions for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-phoenix-contexts/SKILL.md b/skills/elixir-phoenix-phoenix-contexts/SKILL.md
index fb06056..a4ff510 100644
--- a/skills/elixir-phoenix-phoenix-contexts/SKILL.md
+++ b/skills/elixir-phoenix-phoenix-contexts/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-phoenix-contexts
-description: Phoenix context design — creating/splitting contexts, Scope (1.8+), Ecto.Multi,
-  PubSub, routers, plugs, controllers. Use when editing contexts, routers, or designing
-  boundaries.
+description: 'Design or refactor Phoenix contexts, boundaries, and context APIs.'
 metadata:
-  short-description: Phoenix context design — creating/splitting contexts, Scope (1.8+),
-    Ecto.Multi, PubSub, routers, plugs, controllers. Use when editing contexts, routers,
-    or designing boundaries.
+  short-description: 'Design Phoenix context boundaries'
 ---
 
 # Phoenix Contexts Reference
diff --git a/skills/elixir-phoenix-phoenix-contexts/agents/openai.yaml b/skills/elixir-phoenix-phoenix-contexts/agents/openai.yaml
index 3caa537..dc321d3 100644
--- a/skills/elixir-phoenix-phoenix-contexts/agents/openai.yaml
+++ b/skills/elixir-phoenix-phoenix-contexts/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Phoenix Contexts"
-  short_description: "Phoenix context design — creating/splitting contexts, Scope (1.8+), Ecto.Multi, PubSub, routers, plugs, controllers. Use when editing contexts, routers, or designing boundaries."
+  short_description: "Design Phoenix context boundaries"
   default_prompt: "Use $elixir-phoenix-phoenix-contexts for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-plan/SKILL.md b/skills/elixir-phoenix-plan/SKILL.md
index 5eefade..784f0a7 100644
--- a/skills/elixir-phoenix-plan/SKILL.md
+++ b/skills/elixir-phoenix-plan/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-plan
-description: Plan multi-step Phoenix features with specialist agents. Use when building
-  new domains, multi-file features, or creating plans from review findings. Use --existing
-  to enhance a plan.
+description: 'Plan multi-step Phoenix work, new domains, or larger multi-file changes.'
 metadata:
-  short-description: Plan multi-step Phoenix features with specialist agents. Use
-    when building new domains, multi-file features, or creating plans from review
-    findings. Use --existing to enhance a plan.
+  short-description: 'Plan multi-step Phoenix changes'
 ---
 
 # Plan Elixir/Phoenix Feature
diff --git a/skills/elixir-phoenix-plan/agents/openai.yaml b/skills/elixir-phoenix-plan/agents/openai.yaml
index 3046141..722bdd5 100644
--- a/skills/elixir-phoenix-plan/agents/openai.yaml
+++ b/skills/elixir-phoenix-plan/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Plan"
-  short_description: "Plan multi-step Phoenix features with specialist agents. Use when building new domains, multi-file features, or creating plans from review findings. Use --existing to enhance a plan."
+  short_description: "Plan multi-step Phoenix changes"
   default_prompt: "Use $elixir-phoenix-plan for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-pr-review/SKILL.md b/skills/elixir-phoenix-pr-review/SKILL.md
index b5c0bee..98ce86b 100644
--- a/skills/elixir-phoenix-pr-review/SKILL.md
+++ b/skills/elixir-phoenix-pr-review/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-pr-review
-description: Address PR review comments on Elixir/Phoenix code — fetch comments, draft
-  responses, optionally fix code. Use when the user shares a PR URL or mentions reviewer
-  feedback.
+description: 'Handle Phoenix PR review comments: inspect feedback, draft replies, and fix code.'
 metadata:
-  short-description: Address PR review comments on Elixir/Phoenix code — fetch comments,
-    draft responses, optionally fix code. Use when the user shares a PR URL or mentions
-    reviewer feedback.
+  short-description: 'Address Phoenix PR review feedback'
 ---
 
 # PR Review Response
diff --git a/skills/elixir-phoenix-pr-review/agents/openai.yaml b/skills/elixir-phoenix-pr-review/agents/openai.yaml
index 07becce..4f7214e 100644
--- a/skills/elixir-phoenix-pr-review/agents/openai.yaml
+++ b/skills/elixir-phoenix-pr-review/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Pr Review"
-  short_description: "Address PR review comments on Elixir/Phoenix code — fetch comments, draft responses, optionally fix code. Use when the user shares a PR URL or mentions reviewer feedback."
+  short_description: "Address Phoenix PR review feedback"
   default_prompt: "Use $elixir-phoenix-pr-review for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-quick/SKILL.md b/skills/elixir-phoenix-quick/SKILL.md
index 76ecf8d..87d00d0 100644
--- a/skills/elixir-phoenix-quick/SKILL.md
+++ b/skills/elixir-phoenix-quick/SKILL.md
@@ -1,11 +1,8 @@
 ---
 name: elixir-phoenix-quick
-description: Implement small Phoenix changes without planning — add validations, update
-  routes, fix components, create migrations. Use for single-file edits under 50 lines.
+description: 'Implement a small Phoenix change without the full planning workflow.'
 metadata:
-  short-description: Implement small Phoenix changes without planning — add validations,
-    update routes, fix components, create migrations. Use for single-file edits under
-    50 lines.
+  short-description: 'Execute small Phoenix changes'
 ---
 
 # Quick Mode
diff --git a/skills/elixir-phoenix-quick/agents/openai.yaml b/skills/elixir-phoenix-quick/agents/openai.yaml
index e8444c3..1b036b1 100644
--- a/skills/elixir-phoenix-quick/agents/openai.yaml
+++ b/skills/elixir-phoenix-quick/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Quick"
-  short_description: "Implement small Phoenix changes without planning — add validations, update routes, fix components, create migrations. Use for single-file edits under 50 lines."
+  short_description: "Execute small Phoenix changes"
   default_prompt: "Use $elixir-phoenix-quick for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-research/SKILL.md b/skills/elixir-phoenix-research/SKILL.md
index d683516..4cf7c18 100644
--- a/skills/elixir-phoenix-research/SKILL.md
+++ b/skills/elixir-phoenix-research/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-research
-description: Research Elixir/Phoenix topics or evaluate Hex libraries (--library).
-  Use when learning about libraries, patterns, or comparing approaches. Searches HexDocs,
-  ElixirForum, GitHub.
+description: 'Research Phoenix topics or evaluate Hex libraries from primary sources.'
 metadata:
-  short-description: Research Elixir/Phoenix topics or evaluate Hex libraries (--library).
-    Use when learning about libraries, patterns, or comparing approaches. Searches
-    HexDocs, ElixirForum, GitHub.
+  short-description: 'Research Phoenix topics and libraries'
 ---
 
 # Research Elixir Topic
diff --git a/skills/elixir-phoenix-research/agents/openai.yaml b/skills/elixir-phoenix-research/agents/openai.yaml
index 1a3c5a5..0bbd2e3 100644
--- a/skills/elixir-phoenix-research/agents/openai.yaml
+++ b/skills/elixir-phoenix-research/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Research"
-  short_description: "Research Elixir/Phoenix topics or evaluate Hex libraries (--library). Use when learning about libraries, patterns, or comparing approaches. Searches HexDocs, ElixirForum, GitHub."
+  short_description: "Research Phoenix topics and libraries"
   default_prompt: "Use $elixir-phoenix-research for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-review/SKILL.md b/skills/elixir-phoenix-review/SKILL.md
index 130c0f5..671fc8d 100644
--- a/skills/elixir-phoenix-review/SKILL.md
+++ b/skills/elixir-phoenix-review/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-review
-description: 'Elixir/Phoenix: Review code with parallel agents — tests, security,
-  Ecto, LiveView, Oban. Use after implementation to catch bugs and anti-patterns before
-  committing.'
+description: 'Review Phoenix changes with parallel specialists before commit or PR.'
 metadata:
-  short-description: 'Elixir/Phoenix: Review code with parallel agents — tests, security,
-    Ecto, LiveView, Oban. Use after implementation to catch bugs and anti-patterns
-    before committing.'
+  short-description: 'Review Phoenix changes in parallel'
 ---
 
 # Review Elixir/Phoenix Code
diff --git a/skills/elixir-phoenix-review/agents/openai.yaml b/skills/elixir-phoenix-review/agents/openai.yaml
index d72cfda..b742d8a 100644
--- a/skills/elixir-phoenix-review/agents/openai.yaml
+++ b/skills/elixir-phoenix-review/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Review"
-  short_description: "Elixir/Phoenix: Review code with parallel agents — tests, security, Ecto, LiveView, Oban. Use after implementation to catch bugs and anti-patterns before committing."
+  short_description: "Review Phoenix changes in parallel"
   default_prompt: "Use $elixir-phoenix-review for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-security/SKILL.md b/skills/elixir-phoenix-security/SKILL.md
index 743bbb2..2a22f79 100644
--- a/skills/elixir-phoenix-security/SKILL.md
+++ b/skills/elixir-phoenix-security/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-security
-description: Enforce Elixir/Phoenix security — auth, OAuth, sessions, CSRF, XSS, SQL
-  injection, input validation, secrets. Use when editing auth files, login flows,
-  RBAC, or API keys.
+description: 'Review or implement Phoenix auth, authorization, validation, and secret handling.'
 metadata:
-  short-description: Enforce Elixir/Phoenix security — auth, OAuth, sessions, CSRF,
-    XSS, SQL injection, input validation, secrets. Use when editing auth files, login
-    flows, RBAC, or API keys.
+  short-description: 'Review Phoenix security boundaries'
 ---
 
 # Elixir/Phoenix Security Reference
diff --git a/skills/elixir-phoenix-security/agents/openai.yaml b/skills/elixir-phoenix-security/agents/openai.yaml
index 628ce93..8acd770 100644
--- a/skills/elixir-phoenix-security/agents/openai.yaml
+++ b/skills/elixir-phoenix-security/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Security"
-  short_description: "Enforce Elixir/Phoenix security — auth, OAuth, sessions, CSRF, XSS, SQL injection, input validation, secrets. Use when editing auth files, login flows, RBAC, or API keys."
+  short_description: "Review Phoenix security boundaries"
   default_prompt: "Use $elixir-phoenix-security for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-techdebt/SKILL.md b/skills/elixir-phoenix-techdebt/SKILL.md
index 84258ae..7658425 100644
--- a/skills/elixir-phoenix-techdebt/SKILL.md
+++ b/skills/elixir-phoenix-techdebt/SKILL.md
@@ -1,11 +1,8 @@
 ---
 name: elixir-phoenix-techdebt
-description: Analyze Elixir/Phoenix technical debt — duplicates, refactoring opportunities,
-  credo issues. Use when asked about code quality, cleanup, or what to improve.
+description: 'Assess Phoenix technical debt, duplication, cleanup, and refactor targets.'
 metadata:
-  short-description: Analyze Elixir/Phoenix technical debt — duplicates, refactoring
-    opportunities, credo issues. Use when asked about code quality, cleanup, or what
-    to improve.
+  short-description: 'Audit Phoenix technical debt'
 ---
 
 # Technical Debt Detection
diff --git a/skills/elixir-phoenix-techdebt/agents/openai.yaml b/skills/elixir-phoenix-techdebt/agents/openai.yaml
index 241fbdc..e667275 100644
--- a/skills/elixir-phoenix-techdebt/agents/openai.yaml
+++ b/skills/elixir-phoenix-techdebt/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Techdebt"
-  short_description: "Analyze Elixir/Phoenix technical debt — duplicates, refactoring opportunities, credo issues. Use when asked about code quality, cleanup, or what to improve."
+  short_description: "Audit Phoenix technical debt"
   default_prompt: "Use $elixir-phoenix-techdebt for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-testing/SKILL.md b/skills/elixir-phoenix-testing/SKILL.md
index 58ad779..02c8884 100644
--- a/skills/elixir-phoenix-testing/SKILL.md
+++ b/skills/elixir-phoenix-testing/SKILL.md
@@ -1,11 +1,8 @@
 ---
 name: elixir-phoenix-testing
-description: Elixir testing patterns — ExUnit, Mox, factories, LiveView test helpers.
-  Use when working on *_test.exs, test/support/, factory files, or fixing test failures.
+description: 'Apply Elixir testing patterns for ExUnit, Mox, factories, and LiveView.'
 metadata:
-  short-description: Elixir testing patterns — ExUnit, Mox, factories, LiveView test
-    helpers. Use when working on *_test.exs, test/support/, factory files, or fixing
-    test failures.
+  short-description: 'Apply Elixir testing patterns'
 ---
 
 # Elixir Testing Reference
diff --git a/skills/elixir-phoenix-testing/agents/openai.yaml b/skills/elixir-phoenix-testing/agents/openai.yaml
index e7fa693..c3cb7c1 100644
--- a/skills/elixir-phoenix-testing/agents/openai.yaml
+++ b/skills/elixir-phoenix-testing/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Testing"
-  short_description: "Elixir testing patterns — ExUnit, Mox, factories, LiveView test helpers. Use when working on *_test.exs, test/support/, factory files, or fixing test failures."
+  short_description: "Apply Elixir testing patterns"
   default_prompt: "Use $elixir-phoenix-testing for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-tidewave-integration/SKILL.md b/skills/elixir-phoenix-tidewave-integration/SKILL.md
index cabee09..3c21f87 100644
--- a/skills/elixir-phoenix-tidewave-integration/SKILL.md
+++ b/skills/elixir-phoenix-tidewave-integration/SKILL.md
@@ -1,11 +1,8 @@
 ---
 name: elixir-phoenix-tidewave-integration
-description: Tidewave MCP runtime tools — debugging, smoke testing, live state inspection,
-  SQL queries, hex docs. Use when evaluating code in a running Phoenix app.
+description: 'Use Tidewave runtime tools to inspect and smoke-test a running Phoenix app.'
 metadata:
-  short-description: Tidewave MCP runtime tools — debugging, smoke testing, live state
-    inspection, SQL queries, hex docs. Use when evaluating code in a running Phoenix
-    app.
+  short-description: 'Inspect Phoenix runtime with Tidewave'
 ---
 
 # Tidewave MCP Integration
diff --git a/skills/elixir-phoenix-tidewave-integration/agents/openai.yaml b/skills/elixir-phoenix-tidewave-integration/agents/openai.yaml
index 99df21e..862f5d8 100644
--- a/skills/elixir-phoenix-tidewave-integration/agents/openai.yaml
+++ b/skills/elixir-phoenix-tidewave-integration/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Tidewave Integration"
-  short_description: "Tidewave MCP runtime tools — debugging, smoke testing, live state inspection, SQL queries, hex docs. Use when evaluating code in a running Phoenix app."
+  short_description: "Inspect Phoenix runtime with Tidewave"
   default_prompt: "Use $elixir-phoenix-tidewave-integration for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-triage/SKILL.md b/skills/elixir-phoenix-triage/SKILL.md
index 19e3f50..dadee43 100644
--- a/skills/elixir-phoenix-triage/SKILL.md
+++ b/skills/elixir-phoenix-triage/SKILL.md
@@ -1,11 +1,8 @@
 ---
 name: elixir-phoenix-triage
-description: 'Elixir/Phoenix: Triage review findings interactively — approve, skip,
-  or prioritize each issue. Use after $elixir-phoenix-review to filter findings before fixing.'
+description: 'Triage review findings after `$elixir-phoenix-review` before fixing.'
 metadata:
-  short-description: 'Elixir/Phoenix: Triage review findings interactively — approve,
-    skip, or prioritize each issue. Use after $elixir-phoenix-review to filter findings before
-    fixing.'
+  short-description: 'Triage Phoenix review findings'
 ---
 
 # Triage — Interactive Review Resolution
diff --git a/skills/elixir-phoenix-triage/agents/openai.yaml b/skills/elixir-phoenix-triage/agents/openai.yaml
index 78e8de5..c40c8f9 100644
--- a/skills/elixir-phoenix-triage/agents/openai.yaml
+++ b/skills/elixir-phoenix-triage/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Triage"
-  short_description: "Elixir/Phoenix: Triage review findings interactively — approve, skip, or prioritize each issue. Use after $elixir-phoenix-review to filter findings before fixing."
+  short_description: "Triage Phoenix review findings"
   default_prompt: "Use $elixir-phoenix-triage for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-upgrade/SKILL.md b/skills/elixir-phoenix-upgrade/SKILL.md
index 64f3026..0b279f0 100644
--- a/skills/elixir-phoenix-upgrade/SKILL.md
+++ b/skills/elixir-phoenix-upgrade/SKILL.md
@@ -1,10 +1,8 @@
 ---
 name: elixir-phoenix-upgrade
-description: Elixir/Phoenix upgrade workflow — phased dependency upgrades, compatibility
-  checks, deprecation cleanup, and release-safe validation.
+description: 'Plan and execute Phoenix dependency upgrades safely.'
 metadata:
-  short-description: Elixir/Phoenix upgrade workflow — phased dependency upgrades,
-    compatibility checks, deprecation cleanup, and release-safe validation.
+  short-description: 'Plan safe Phoenix upgrades'
 ---
 
 # Upgrade Workflow
diff --git a/skills/elixir-phoenix-verify/SKILL.md b/skills/elixir-phoenix-verify/SKILL.md
index 7ba7a4b..1f0fee2 100644
--- a/skills/elixir-phoenix-verify/SKILL.md
+++ b/skills/elixir-phoenix-verify/SKILL.md
@@ -1,10 +1,8 @@
 ---
 name: elixir-phoenix-verify
-description: Verify Elixir/Phoenix changes — compile, format, and test in one loop.
-  Use after implementation, before PRs, or after fixing bugs.
+description: 'Compile, format, and test Phoenix changes in one verification loop.'
 metadata:
-  short-description: Verify Elixir/Phoenix changes — compile, format, and test in
-    one loop. Use after implementation, before PRs, or after fixing bugs.
+  short-description: 'Run Phoenix compile-format-test checks'
 ---
 
 # Verification Loop
diff --git a/skills/elixir-phoenix-verify/agents/openai.yaml b/skills/elixir-phoenix-verify/agents/openai.yaml
index 10a0c43..4f10b6f 100644
--- a/skills/elixir-phoenix-verify/agents/openai.yaml
+++ b/skills/elixir-phoenix-verify/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Verify"
-  short_description: "Verify Elixir/Phoenix changes — compile, format, and test in one loop. Use after implementation, before PRs, or after fixing bugs."
+  short_description: "Run Phoenix compile-format-test checks"
   default_prompt: "Use $elixir-phoenix-verify for this Elixir/Phoenix task."
diff --git a/skills/elixir-phoenix-work/SKILL.md b/skills/elixir-phoenix-work/SKILL.md
index be2b101..be24c90 100644
--- a/skills/elixir-phoenix-work/SKILL.md
+++ b/skills/elixir-phoenix-work/SKILL.md
@@ -1,12 +1,8 @@
 ---
 name: elixir-phoenix-work
-description: Execute Elixir/Phoenix plan tasks with progress tracking. Use after $elixir-phoenix-plan
-  to implement features with mix compile and mix test verification after each step,
-  or --continue to resume interrupted work.
+description: 'Execute a Phoenix plan step by step with progress tracking and verification.'
 metadata:
-  short-description: Execute Elixir/Phoenix plan tasks with progress tracking. Use
-    after $elixir-phoenix-plan to implement features with mix compile and mix test verification
-    after each step, or --continue to resume interrupted work.
+  short-description: 'Execute Phoenix plans with verification'
 ---
 
 # Work
diff --git a/skills/elixir-phoenix-work/agents/openai.yaml b/skills/elixir-phoenix-work/agents/openai.yaml
index 3704800..ce7dd8b 100644
--- a/skills/elixir-phoenix-work/agents/openai.yaml
+++ b/skills/elixir-phoenix-work/agents/openai.yaml
@@ -1,4 +1,4 @@
 interface:
   display_name: "Work"
-  short_description: "Execute Elixir/Phoenix plan tasks with progress tracking. Use after $elixir-phoenix-plan to implement features with mix compile and mix test verification after each step, or --continue to resume interrupted work."
+  short_description: "Execute Phoenix plans with verification"
   default_prompt: "Use $elixir-phoenix-work for this Elixir/Phoenix task."