refactor: trim elixir skill metadata

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."

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

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."