From elixir-ash-zway
Search for package-specific usage rules and best practices from Elixir packages. Use when you need coding conventions, patterns, common mistakes, getting an overview about the project, when the ash-plan command/skill is used, or good/bad examples for packages like Ash, Phoenix, Ecto, etc.
How this skill is triggered — by the user, by Claude, or both
Slash command
/elixir-ash-zway:usage-rulesThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Find package-specific best practices and coding conventions from `usage-rules.md` files.
Find package-specific best practices and coding conventions from usage-rules.md files.
A community convention where packages include a usage-rules.md file with:
# GOOD, # BAD, # AVOID)deps/<package>/usage-rules.md.usage-rules/<package>-<version>/usage-rules.mdPrimarily the Ash ecosystem:
ash, ash_postgres, ash_phoenix, ash_json_api, ash_graphqlspark, igniter, reactorMost packages (Phoenix, Ecto, etc.) do not have usage-rules.md yet. For those, suggest hex-docs-search skill or official guides.
# Fetch package and extract usage-rules.md
mix hex.package fetch <package> <version> --unpack --output .usage-rules/.tmp/<package>-<version>
# If usage-rules.md exists, copy to cache
if [ -f ".usage-rules/.tmp/<package>-<version>/usage-rules.md" ]; then
mkdir -p ".usage-rules/<package>-<version>"
cp ".usage-rules/.tmp/<package>-<version>/usage-rules.md" ".usage-rules/<package>-<version>/"
fi
# Clean up
rm -rf ".usage-rules/.tmp/<package>-<version>"
Mention adding .usage-rules/ to .gitignore once per session when fetching occurs.
Usage rules files can be large. Extract relevant sections based on user's question:
| User Context | Look for Sections |
|---|---|
| querying, filters | "Querying", "Filters", "Read Actions" |
| actions, create/update | "Actions", "Changes", "Validations" |
| relationships | "Relationships", "Aggregates" |
| errors, validation | "Error Handling", "Validations" |
| authorization | "Policies", "Authorization" |
| testing | "Testing" |
Find section headings with line numbers, then extract the relevant section content.
# GOOD vs # BAD patterns explicitlyhex-docs-search for API documentation (complementary)npx claudepluginhub jusi-dev/dev-marketplace --plugin elixir-ash-zwaySearches usage-rules.md files in Elixir packages like Ash, Phoenix, Ecto for conventions, patterns, good/bad examples, and mistakes. Extracts context-specific sections.
Searches Elixir packages like Ash, Phoenix, Ecto for usage rules, best practices, conventions, patterns, common mistakes, and code examples via local deps or fetch.
Researches Elixir/Phoenix topics or evaluates Hex libraries by searching HexDocs, ElixirForum, and GitHub. Use for learning patterns, comparing approaches, or library assessments.