Thanks for your interest. Bug reports, ideas, and questions are all welcome.
Open an issue using the Bug report template. Include:
- What you ran (skill version, the command you used)
- What you expected to happen
- What actually happened (error messages, screenshots, or output excerpts)
- Project context (Swift version, Xcode version, approximate codebase size)
Open an issue using the Feature request template. If you can link it to a real bug the audit missed or a real workflow that broke, include that: concrete cases beat abstract ideas.
Start a thread in Discussions. Keeps the issue tracker focused on actionable work.
workflow-audit is primarily a SKILL.md file plus supporting docs. Most contributions are edits to the skill's audit rules, new detection patterns, or documentation.
- Fork the repo
- Create a branch off
main - Make your changes
- Open a PR describing the change and linking to any issue it addresses
For substantive changes (new audit categories, structural rewrites), open an issue first to discuss scope before writing code.
If you found this skill via Claude Code or a similar tool, feedback from actual audit runs is especially valuable. Before-and-after examples, cases the skill missed, false positives: these are the highest-signal reports.