usage-rules

Usage rules for Elixir and Erlang libraries are surfaced by searching local dependencies, consulting cached rules, and automatically fetching missing ones. The Skill extracts relevant sections like Querying, Error Handling, Actions, Relationships, and Testing to provide context-aware guidance for your project's exact versions.

Yes. The Skill caches fetched rules in .usage-rules/ for offline access after the first fetch. It prioritizes local deps/ and cached rules before attempting to download, ensuring you can reference usage conventions without internet connectivity.

The Skill locates Ash usage rules from your project's locked version in mix.lock, extracts sections specific to Querying or Error Handling, and presents concise guidance. It automatically detects your installed version and retrieves the matching rules.

When rules are missing, the Skill provides fallback guidance based on general best practices. It also attempts progressive fetching to download and cache rules for future use, building your offline reference library over time.

The Skill applies to any Elixir or Erlang library in your hex.pm dependencies. It detects versions from mix.lock and mix.exs, then searches for and extracts usage conventions. Coverage depends on whether usage-rules.md exists in the package documentation.

Yes. The Skill searches local deps/ for usage-rules.md in any dependency, including custom or private packages. As long as the package is in your project's deps directory, its rules can be discovered and cached.