Update Project Skill

Re-analyze project source and regenerate one or more files under skills/.

User Input

$ARGUMENTS

Target Selection

If $ARGUMENTS contains all, update both project skills.
Else if $ARGUMENTS contains duskmoon_bundler or duskmoon-bundler, update only skills/duskmoon_bundler/.
Else if $ARGUMENTS contains phoenix-duskmoon-ui, phoenix_duskmoon, or phoenix-duskmoon, update only skills/phoenix-duskmoon-ui/.
Else if $ARGUMENTS is empty, update skills/phoenix-duskmoon-ui/ for backward compatibility.

Only touch files for the selected target skill(s).

Phoenix Duskmoon UI Skill

Regenerate skills/phoenix-duskmoon-ui/SKILL.md and skills/phoenix-duskmoon-ui/references/components.md.

1. Scan all component modules

Read every .ex file under:

apps/phoenix_duskmoon/lib/phoenix_duskmoon/component/
apps/phoenix_duskmoon/lib/phoenix_duskmoon/css_art/

For each module, extract:

Module name and category from the path: action, data_display, data_entry, feedback, navigation, layout, icon, fun
All public def functions with @doc type: :component
All attr/3 declarations: name, type, default, values
All slot/2 declarations: name, attrs
Whether the component requires a LiveView hook

2. Scan setup files

Read these files for integration details:

apps/phoenix_duskmoon/mix.exs - version, deps
apps/phoenix_duskmoon/package.json - npm exports
apps/phoenix_duskmoon/assets/js/hooks/index.js - exported hooks
apps/phoenix_duskmoon/assets/css/phoenix_duskmoon.css - CSS imports
apps/phoenix_duskmoon/lib/phoenix_duskmoon/component.ex - main import module
apps/phoenix_duskmoon/lib/phoenix_duskmoon/css_art.ex - CSS art import module

3. Regenerate SKILL.md

Update skills/phoenix-duskmoon-ui/SKILL.md with:

Current version number from mix.exs
Installation instructions: Hex and npm
Setup steps: Elixir imports, CSS, JS hooks, element registration
Architecture overview: v9 custom elements
Hooks reference table
Component quick reference tables organized by category
Usage examples covering common patterns
npm package exports table

Keep the YAML frontmatter name and description fields. Keep SKILL.md under 500 lines and put detailed reference in the components file.

4. Regenerate components.md

Update skills/phoenix-duskmoon-ui/references/components.md with the full attribute and slot reference for every component, organized by category.

5. Verify accuracy

After regenerating, spot-check 3-5 components by reading their source to confirm the documented attrs and slots match the actual code. Fix discrepancies.

6. Report changes

List what changed:

New components added
Components removed
Attributes changed
Version updated

Duskmoon Bundler Skill

Regenerate skills/duskmoon_bundler/SKILL.md and keep skills/duskmoon_bundler/agents/openai.yaml aligned if the skill description or default prompt changes.

1. Scan package metadata

Read:

apps/duskmoon_bundler/mix.exs - version, deps, aliases, docs groups
apps/duskmoon_bundler_runtime/mix.exs - runtime version and public modules
apps/duskmoon_npm/mix.exs - npm task package version and public docs groups
apps/duskmoon_bundler/package.json - package name and frontend/runtime deps
Root config/config.exs, config/dev.exs, and config/test.exs - in-repo profile examples and lint config

Keep package versions current. If duskmoon_bundler, duskmoon_bundler_runtime, and duskmoon_npm versions differ, document each explicitly.

2. Scan user-facing docs

Read the current setup and feature docs before editing the skill:

apps/duskmoon_bundler/README.md
apps/duskmoon_bundler/guides/introduction/getting-started.md
apps/duskmoon_bundler/guides/deployment/production-builds.md
apps/duskmoon_bundler/guides/features/features.md
apps/duskmoon_bundler/guides/features/formatting-and-linting.md
apps/duskmoon_bundler/guides/features/tailwind.md
apps/duskmoon_npm/README.md
apps/duskmoon_npm/guides/introduction/getting-started.md
apps/duskmoon_npm/guides/reference/mix-tasks.md
apps/duskmoon_npm/guides/workflows/dependencies.md
apps/duskmoon_npm/guides/workflows/ci.md

Read feature-specific docs only when the skill needs that topic:

apps/duskmoon_bundler/guides/features/frameworks.md
apps/duskmoon_bundler/guides/features/plugins.md
apps/duskmoon_bundler/guides/features/environment-variables.md
apps/duskmoon_bundler/guides/features/static-assets.md
apps/duskmoon_bundler/guides/features/code-splitting.md
apps/duskmoon_bundler/guides/migration/from-esbuild.md

3. Scan implementation docs from source

Read module docs and task docs that define the real API:

apps/duskmoon_bundler/lib/duskmoon_bundler/config.ex
apps/duskmoon_bundler/lib/duskmoon_bundler/config/build.ex
apps/duskmoon_bundler/lib/duskmoon_bundler/config/server.ex
apps/duskmoon_bundler/lib/duskmoon_bundler/dev_server.ex
apps/duskmoon_bundler/lib/duskmoon_bundler/formatter.ex
apps/duskmoon_bundler/lib/mix/tasks/duskmoon_bundler.install.ex
apps/duskmoon_bundler/lib/mix/tasks/duskmoon_bundler.build.ex
apps/duskmoon_bundler/lib/mix/tasks/duskmoon_bundler.dev.ex
apps/duskmoon_bundler/lib/mix/tasks/duskmoon_bundler.js.format.ex
apps/duskmoon_bundler/lib/mix/tasks/duskmoon_bundler.js.check.ex
apps/duskmoon_bundler/lib/mix/tasks/duskmoon_bundler.lint.ex
apps/duskmoon_bundler_runtime/lib/duskmoon_bundler.ex
apps/duskmoon_bundler_runtime/lib/duskmoon_bundler/preload.ex
apps/duskmoon_bundler_runtime/lib/duskmoon_bundler/runtime/config.ex
apps/duskmoon_npm/lib/mix/tasks/npm.install.ex
apps/duskmoon_npm/lib/mix/tasks/npm.ci.ex
apps/duskmoon_npm/lib/mix/tasks/npm.run.ex
apps/duskmoon_npm/lib/mix/tasks/npm.exec.ex

Use source docs over older guides when they disagree.

4. Regenerate SKILL.md

Update skills/duskmoon_bundler/SKILL.md with:

YAML frontmatter with name: duskmoon-bundler; keep the directory name duskmoon_bundler
A trigger-rich description covering install, config, dev server, runtime helpers, production builds, Tailwind, formatter, lint, named profiles, and migration from esbuild, Tailwind CLI, Bun, npm, and yarn workflows
Current package version(s)
Recommended setup path using mix igniter.install duskmoon_bundler
Manual dependency setup with :duskmoon_bundler_runtime and :duskmoon_bundler
duskmoon_npm usage for package management and when to add :duskmoon_npm explicitly
Replacement guidance: use DuskmoonBundler for esbuild/Tailwind assets and mix npm.install instead of bun add, bun install, npm install, or yarn install
npm workflow commands: mix npm.init, mix npm.install, mix npm.install package, mix npm.install package --save-dev, mix npm.ci, mix npm.install --frozen, mix npm.verify, mix npm.run script, and mix npm.exec binary
Umbrella npm workspace guidance: root package.json, per-web-app manifests, root npm.lock, and running mix npm.install from the umbrella root
Warning not to use only: :dev for :duskmoon_bundler
Single-app and named-profile config examples
Dev server plug and watcher examples, including profile usage
Layout helper examples for DuskmoonBundler.static_path/2 and DuskmoonBundler.Preload.tags/2
Production build commands and alias guidance
Formatting and linting setup and commands
Validation commands for normal apps and profile-specific umbrella builds
Troubleshooting for dev asset 404s, manifest misses, Tailwind source misses, and umbrella dependency resolution

Keep SKILL.md concise and under 500 lines. Do not create extra README, quick-reference, changelog, or installation guide files inside the skill.

5. Update agents/openai.yaml if needed

If the generated skill changes the user-facing purpose, update skills/duskmoon_bundler/agents/openai.yaml so it still matches:

interface:
  display_name: "Duskmoon Bundler"
  short_description: "Setup and use Duskmoon Bundler"
  default_prompt: "Use $duskmoon-bundler to set up Phoenix assets with DuskmoonBundler."

Keep strings quoted and keep the default prompt explicitly mentioning $duskmoon-bundler.

6. Verify accuracy

Spot-check at least these flows against source or docs:

Installer edits from Mix.Tasks.DuskmoonBundler.Install
mix duskmoon_bundler.build and mix duskmoon_bundler.dev options
Runtime helper ownership in duskmoon_bundler_runtime
Named profile usage in config/config.exs and dev watcher config
mix npm.install, mix npm.ci, mix npm.run, and mix npm.exec behavior
JS/TS format and lint commands

Validate the skill structure:

uv run --with pyyaml python /home/gao/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/duskmoon_bundler

7. Report changes