# Change Log All notable changes to this project will be documented in this file. See [Conventional Commits](Https://conventionalcommits.org) for commit guidelines. ## v1.2.6 (2026-04-13) ### Bug Fixes: * only generate reference links for deps with actual content by Zach Daniel * normalize deps skill names per agentskills.io spec (#68) by Florian Kapfenberger * documentation retrieval for callbacks (#60) (#60) by Iulian Costan * filter out deps without usage rules in skills.build (#64) by Adam Royle ## v1.2.5 (2026-03-09) ### Bug Fixes: * --check false positive after disk round-trip due to eof_newline mismatch (#59) by Barnabas Jovanovics ## v1.2.4 (2026-03-02) ### Improvements: * link to md docs before html docs, and hint at search_docs by Zach Daniel ## v1.2.3 (2026-02-27) ## v1.2.2 (2026-02-26) ### Improvements: * support copying skills shipped directly by packages by Zach Daniel ## v1.2.1 (2026-02-18) ### Bug Fixes: * deduplicate skill references when sub-rule name matches package name (#56) (#57) by Tom Meier ## v1.2.0 (2026-02-18) ### Features: * support options for :all in usage_rules config (#53) by Jinkyou Son ### Improvements: * allow excluding main usage-rules.md while including sub-rules by Zach Daniel ## v1.1.0 (2026-02-11) ### Features: * include sub_rules by default instead of on selection or `:all` by Zach Daniel ## v1.0.3 (2026-02-10) ### Bug Fixes: * ensure multiline skill descriptions are formatted properly by Zach Daniel ## v1.0.2 (2026-02-10) Fix examples in error outputs and docs ## v1.0.1 (2026-02-10) ### Improvements: * regexes in usage rule deps, add examples by Zach Daniel ## v1.0.0-rc.3 (2026-02-10) ### Improvements: * use refernece files for all usage rules by Zach Daniel ## v1.0.0-rc.2 (2026-02-07) ### Improvements: * reference mode for skill deps by Zach Daniel ## v1.0.0-rc.1 (2026-02-07) ### Improvements: * make package inlining configured per-dep, clean ups by Zach Daniel ## v1.0.0-rc.0 (2026-02-07) ### Breaking Changes: * rebuild usage rules to be config-driven and support agent skills by Zach Daniel ## v0.1.26 (2025-11-05) ### Bug Fixes: * Include rules from all apps in umbrella project (#37) by Nathan Alderson ## v0.1.25 (2025-10-14) ### Bug Fixes: * use AGENTS.md consistently in task help (#28) by Lars Wikman ### Improvements: * Impl `supports_umbrella?` (#33) by Wigny * Add ability to extract one or more usage rules to folder without modifying any files. (#29) by olivermt ## v0.1.24 (2025-08-31) ### Bug Fixes: * typo in OTP usage rules (#22) by Hubert Pompecki ### Improvements: * Add warning about %{} pattern matching (#23) by jlgeering ## v0.1.23 (2025-07-22) ### Bug Fixes: * trim trailing application descriptions by Zach Daniel ## v0.1.22 (2025-07-19) ### Bug Fixes: * make igniter not an optional dependency, but a normal one by Zach Daniel ### Improvements: * show `mix help test` in testing usage rules by Zach Daniel * add a debugging header to elixir usage rules by Zach Daniel ## v0.1.21 (2025-07-17) ### Improvements: * only show notice about local docs when module is compiled by Zach Daniel ## v0.1.20 (2025-07-17) ### Improvements: * add `mix usage_rules.docs` by Zach Daniel ## v0.1.19 (2025-07-17) ### Improvements: * add --query-by option to mix task by Zach Daniel ## v0.1.18 (2025-07-17) ### Improvements: * add `usage_rules.search_docs` task by Zach Daniel * instruct agents to use the new task by Zach Daniel * explain about no early returns in usage rules by Zach Daniel * add a note on early returns not being a thing in usage-rules.md by Zach Daniel ## v0.1.17 (2025-07-17) ### Improvements: * replace auto-sync with notice (#12) by andyl ## v0.1.16 (2025-07-10) ## v0.1.15 (2025-07-02) ### Improvements: * support sub-rules, in a usage-rules folder by Zach Daniel * remove --builtins option * add --remove-missing option by Zach Daniel * add notice when using --all about the dangers of it by Zach Daniel * update usage rules for Elixir by Zach Daniel ## [Unreleased] ### Features: * add sub-rules support - Packages can now have a `usage_rules/` folder with multiple sub-rule files that can be included individually using `package:rule` syntax or all at once with `package:all` * add `--inline` option - Force specific packages to be inlined even when using `--link-to-folder`. Supports special `usage_rules:all` spec to inline all sub-rules while linking main packages ## v0.1.14 (2025-06-26) ### Improvements: * update installer by Zach Daniel ## v0.1.13 (2025-06-26) ### Improvements: * trim testing usage rules by Zach Daniel ## v0.1.12 (2025-06-25) ### Improvements: * add testing usage rules by Zach Daniel ## v0.1.11 (2025-06-25) ### Improvements: * add descriptions to usage rules by Zach Daniel * make builtin usage rules always show inline by Zach Daniel ## v0.1.10 (2025-06-25) ### Improvements: * guard against excessive macro usage in elixir rules by Zach Daniel ## v0.1.9 (2025-06-24) ### Bug Fixes: * don't mention hd/1 or tl/1 in elixir usage rules by Zach Daniel ## v0.1.8 (2025-06-24) ### Improvements: * remove a confusing usage rule on list purposes by Zach Daniel * add a usage rule about indexing lists/enumerables by Zach Daniel * add builtin usage rules by Zach Daniel ## v0.1.7 (2025-06-23) ### Bug Fixes: * usage proper markdown comments by Zach Daniel ## v0.1.6 (2025-06-06) ### Improvements: * add `--link-to-folder deps` option, and recommend its use ## v0.1.5 (2025-06-06) ### Improvements: * use markdown links by default, allow opting in to `--link-style at` ## v0.1.4 (2025-06-06) ### Improvements: * add `--link-to-folder` option ## v0.1.3 (2025-05-24) ### Bug Fixes: * update package url in docs & hex ## v0.1.2 (2025-05-24) ### Bug Fixes: * replace package-rules with usage-rules ## v0.1.1 (2025-05-24) ### Improvements: * only suggest top-level deps ## v0.1.0 (2025-05-24) ### Bug Fixes: * bugs w/ duplicating content ### Improvements: * add `--remove` option * port initial feature set over and test it